Developers

Avero API

A REST API over your CRM data — deals, persons, organizations, activities and notes. Build your own integrations, sync your stack, automate your pipeline.

Create an API key

Activities

Calls, meetings, tasks and other scheduled work, linked to deals, persons or organizations.

GET/api/v1/activities20 TOKENS
List activities

Returns activities, newest first. Supports pagination and the filters below.

NameInTypeDescription
startqueryintegerPagination offset. Default 0.
limitqueryintegerItems per page. Default 100, max 500.
updated_sincequerydatetimeOnly records updated at or after this ISO 8601 timestamp — for incremental sync. Datetimes must include a timezone offset (e.g. 2026-07-15T10:00:00Z); date-only values are read as UTC.
deal_idqueryuuidFilter by deal.
person_idqueryuuidFilter by person.
organization_idqueryuuidFilter by organization.
typequeryenumCall, Meeting, Task, Email, Deadline, Lunch.
donequerybooleanFilter by completion.
Request
curl -X GET "https://app.averocrm.com/api/v1/activities" \
  -H "x-api-token: $AVERO_API_TOKEN"
Response
{
  "success": true,
  "data": [
    {
      "id": "9b2f7e34-1c5d-4a8e-b7f0-3d2a6c9e8f10",
      "type": "Call",
      "title": "Discovery call with Ana",
      "deal_id": "7c1e5a90-2b4f-4d3c-9e8a-6f0b1d2c3e4a",
      "person_id": null,
      "organization_id": null,
      "owner_id": null,
      "starts_at": "2026-07-16T10:00:00.000Z",
      "ends_at": "2026-07-16T10:30:00.000Z",
      "done": false,
      "done_at": null,
      "created_at": "2026-07-14T09:30:00.000Z",
      "updated_at": "2026-07-14T09:30:00.000Z"
    }
  ],
  "additional_data": {
    "pagination": {
      "start": 0,
      "limit": 100,
      "more_items_in_collection": false
    }
  }
}
GET/api/v1/activities/{id}2 TOKENS
Get a activity

Returns one activity by id.

NameInTypeDescription
id *pathuuidThe record's id.
Request
curl -X GET "https://app.averocrm.com/api/v1/activities/9b2f7e34-1c5d-4a8e-b7f0-3d2a6c9e8f10" \
  -H "x-api-token: $AVERO_API_TOKEN"
Response
{
  "success": true,
  "data": {
    "id": "9b2f7e34-1c5d-4a8e-b7f0-3d2a6c9e8f10",
    "type": "Call",
    "title": "Discovery call with Ana",
    "deal_id": "7c1e5a90-2b4f-4d3c-9e8a-6f0b1d2c3e4a",
    "person_id": null,
    "organization_id": null,
    "owner_id": null,
    "starts_at": "2026-07-16T10:00:00.000Z",
    "ends_at": "2026-07-16T10:30:00.000Z",
    "done": false,
    "done_at": null,
    "created_at": "2026-07-14T09:30:00.000Z",
    "updated_at": "2026-07-14T09:30:00.000Z"
  },
  "additional_data": null
}
POST/api/v1/activities10 TOKENS
Create a activity

Creates a activity. Unknown fields are rejected.

NameInTypeDescription
typebodyenumCall | Meeting | Task | Email | Deadline | Lunch. Default Call.
titlebodystringActivity title.
bodybodystringDetails.
notebodystringInternal note.
prioritybodystringPriority label.
locationbodystringWhere it happens.
starts_atbodydatetimeStart (ISO 8601).
ends_atbodydatetimeEnd (ISO 8601).
donebodybooleanCompletion flag — sets/clears done_at.
deal_idbodyuuidLinked deal.
person_idbodyuuidLinked person.
organization_idbodyuuidLinked organization.
owner_idbodyuuidOwning sales rep.
Request
curl -X POST "https://app.averocrm.com/api/v1/activities" \
  -H "x-api-token: $AVERO_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"Call","title":"Discovery call with Ana","starts_at":"2026-07-16T10:00:00.000Z","deal_id":"7c1e5a90-2b4f-4d3c-9e8a-6f0b1d2c3e4a"}'
Response
{
  "success": true,
  "data": {
    "id": "9b2f7e34-1c5d-4a8e-b7f0-3d2a6c9e8f10",
    "type": "Call",
    "title": "Discovery call with Ana",
    "deal_id": "7c1e5a90-2b4f-4d3c-9e8a-6f0b1d2c3e4a",
    "person_id": null,
    "organization_id": null,
    "owner_id": null,
    "starts_at": "2026-07-16T10:00:00.000Z",
    "ends_at": "2026-07-16T10:30:00.000Z",
    "done": false,
    "done_at": null,
    "created_at": "2026-07-14T09:30:00.000Z",
    "updated_at": "2026-07-14T09:30:00.000Z"
  },
  "additional_data": null
}
PATCH/api/v1/activities/{id}10 TOKENS
Update a activity

Updates the given fields of a activity. PUT is accepted as an alias.

NameInTypeDescription
id *pathuuidThe record's id.
typebodyenumCall | Meeting | Task | Email | Deadline | Lunch. Default Call.
titlebodystringActivity title.
bodybodystringDetails.
notebodystringInternal note.
prioritybodystringPriority label.
locationbodystringWhere it happens.
starts_atbodydatetimeStart (ISO 8601).
ends_atbodydatetimeEnd (ISO 8601).
donebodybooleanCompletion flag — sets/clears done_at.
deal_idbodyuuidLinked deal.
person_idbodyuuidLinked person.
organization_idbodyuuidLinked organization.
owner_idbodyuuidOwning sales rep.
Request
curl -X PATCH "https://app.averocrm.com/api/v1/activities/9b2f7e34-1c5d-4a8e-b7f0-3d2a6c9e8f10" \
  -H "x-api-token: $AVERO_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"Call"}'
Response
{
  "success": true,
  "data": {
    "id": "9b2f7e34-1c5d-4a8e-b7f0-3d2a6c9e8f10",
    "type": "Call",
    "title": "Discovery call with Ana",
    "deal_id": "7c1e5a90-2b4f-4d3c-9e8a-6f0b1d2c3e4a",
    "person_id": null,
    "organization_id": null,
    "owner_id": null,
    "starts_at": "2026-07-16T10:00:00.000Z",
    "ends_at": "2026-07-16T10:30:00.000Z",
    "done": false,
    "done_at": null,
    "created_at": "2026-07-14T09:30:00.000Z",
    "updated_at": "2026-07-14T09:30:00.000Z"
  },
  "additional_data": null
}
DELETE/api/v1/activities/{id}6 TOKENS
Delete a activity

Deletes a activity permanently.

NameInTypeDescription
id *pathuuidThe record's id.
Request
curl -X DELETE "https://app.averocrm.com/api/v1/activities/9b2f7e34-1c5d-4a8e-b7f0-3d2a6c9e8f10" \
  -H "x-api-token: $AVERO_API_TOKEN"
Response
{
  "success": true,
  "data": {
    "id": "9b2f7e34-1c5d-4a8e-b7f0-3d2a6c9e8f10"
  },
  "additional_data": null
}