Skip to main content
GET

List all events

Scope:crm:events.read
https://api.holded.com/api/v2/events

Returns a paginated list of CRM events. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Default page size is 50, configurable up to 100 with `limit`.

Parameters

Query parameters

cursorstringoptional

Pagination cursor from a previous response

limitintegeroptional= 50

Maximum number of items to return

Request

python
import requests

url = "https://api.holded.com/api/v2/events?cursor=value&limit=50"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Responses

Response

json
{
  "items": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "string",
      "contact_id": "string",
      "contact_name": "string",
      "kind": "string",
      "description": "string",
      "start_date": "2024-01-15T10:30:00Z",
      "end_date": "2024-01-15T10:30:00Z",
      "status": 0,
      "tags": [
        "string"
      ],
      "location": "string",
      "lead_id": "string",
      "funnel_id": "string",
      "user_id": "string",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ],
  "cursor": "string",
  "has_more": false
}

Success responses

200List of eventsapplication/json
object
items[]object[]required
idstringrequired

Unique identifier of the event

namestringrequired

Event name

contact_idstring | nullrequired

Associated contact ID

contact_namestring | nullrequired

Contact display name

kindstring | nullrequired

Activity type key (e.g. call, meeting, task)

descriptionstring | nullrequired

Event description

start_datestring<date-time> | nullrequired

Start date in ISO 8601 format

end_datestring<date-time> | nullrequired

End date in ISO 8601 format

statusintegerrequired

Event status (0 = pending, 1 = completed)

tags[]string[]required

List of tag names

locationstring | nullrequired

Event location

lead_idstring | nullrequired

Associated deal/lead ID

funnel_idstring | nullrequired

Associated funnel ID

user_idstring | nullrequired

ID of the user assigned to the event

created_atstring<date-time> | nullrequired

Creation date in ISO 8601 format

updated_atstring<date-time> | nullrequired

Last update date in ISO 8601 format

cursorstring | nulloptional
has_morebooleanrequired

Error responses

401Invalid or missing API keyapplication/json
403Insufficient permissionsapplication/json
429Rate limit exceededapplication/json