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

Organizations

The companies and groups your deals are sold to — corporate accounts, agencies and event planners.

GET/api/v1/organizations20 TOKENS
List organizations

Returns organizations, 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.
namequerystringFilter by name (partial match).
Request
curl -X GET "https://app.averocrm.com/api/v1/organizations" \
  -H "x-api-token: $AVERO_API_TOKEN"
Response
{
  "success": true,
  "data": [
    {
      "id": "9b2f7e34-1c5d-4a8e-b7f0-3d2a6c9e8f10",
      "name": "Northwind Software",
      "location": "Zagreb, Croatia",
      "keys": null,
      "website": "https://northwind.io",
      "current_ota": null,
      "direct_booking_site": null,
      "address": "Ilica 45, 10000 Zagreb",
      "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/organizations/{id}2 TOKENS
Get a organization

Returns one organization by id.

NameInTypeDescription
id *pathuuidThe record's id.
Request
curl -X GET "https://app.averocrm.com/api/v1/organizations/9b2f7e34-1c5d-4a8e-b7f0-3d2a6c9e8f10" \
  -H "x-api-token: $AVERO_API_TOKEN"
Response
{
  "success": true,
  "data": {
    "id": "9b2f7e34-1c5d-4a8e-b7f0-3d2a6c9e8f10",
    "name": "Northwind Software",
    "location": "Zagreb, Croatia",
    "keys": null,
    "website": "https://northwind.io",
    "current_ota": null,
    "direct_booking_site": null,
    "address": "Ilica 45, 10000 Zagreb",
    "created_at": "2026-07-14T09:30:00.000Z",
    "updated_at": "2026-07-14T09:30:00.000Z"
  },
  "additional_data": null
}
POST/api/v1/organizations10 TOKENS
Create a organization

Creates a organization. Unknown fields are rejected.

NameInTypeDescription
name *bodystringOrganization name.
locationbodystringCity / region.
keysbodyintegerNumber of keys (rooms/units), for organizations that are properties.
websitebodystringWebsite URL.
current_otabodystringOTA the organization sells through, for property-type organizations.
direct_booking_sitebodystringExisting direct booking site, if any.
addressbodystringStreet address.
Request
curl -X POST "https://app.averocrm.com/api/v1/organizations" \
  -H "x-api-token: $AVERO_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Northwind Software","location":"Zagreb, Croatia"}'
Response
{
  "success": true,
  "data": {
    "id": "9b2f7e34-1c5d-4a8e-b7f0-3d2a6c9e8f10",
    "name": "Northwind Software",
    "location": "Zagreb, Croatia",
    "keys": null,
    "website": "https://northwind.io",
    "current_ota": null,
    "direct_booking_site": null,
    "address": "Ilica 45, 10000 Zagreb",
    "created_at": "2026-07-14T09:30:00.000Z",
    "updated_at": "2026-07-14T09:30:00.000Z"
  },
  "additional_data": null
}
PATCH/api/v1/organizations/{id}10 TOKENS
Update a organization

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

NameInTypeDescription
id *pathuuidThe record's id.
namebodystringOrganization name.
locationbodystringCity / region.
keysbodyintegerNumber of keys (rooms/units), for organizations that are properties.
websitebodystringWebsite URL.
current_otabodystringOTA the organization sells through, for property-type organizations.
direct_booking_sitebodystringExisting direct booking site, if any.
addressbodystringStreet address.
Request
curl -X PATCH "https://app.averocrm.com/api/v1/organizations/9b2f7e34-1c5d-4a8e-b7f0-3d2a6c9e8f10" \
  -H "x-api-token: $AVERO_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Northwind Software"}'
Response
{
  "success": true,
  "data": {
    "id": "9b2f7e34-1c5d-4a8e-b7f0-3d2a6c9e8f10",
    "name": "Northwind Software",
    "location": "Zagreb, Croatia",
    "keys": null,
    "website": "https://northwind.io",
    "current_ota": null,
    "direct_booking_site": null,
    "address": "Ilica 45, 10000 Zagreb",
    "created_at": "2026-07-14T09:30:00.000Z",
    "updated_at": "2026-07-14T09:30:00.000Z"
  },
  "additional_data": null
}
DELETE/api/v1/organizations/{id}6 TOKENS
Delete a organization

Deletes a organization permanently.

NameInTypeDescription
id *pathuuidThe record's id.
Request
curl -X DELETE "https://app.averocrm.com/api/v1/organizations/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
}