List all events
crm:events.readhttps://api.holded.com/api/v2/eventsReturns 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
stringoptionalPagination cursor from a previous response
integeroptional= 50Maximum number of items to return
Request
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
{
"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/jsonUnique identifier of the event
Event name
Associated contact ID
Contact display name
Activity type key (e.g. call, meeting, task)
Event description
Start date in ISO 8601 format
End date in ISO 8601 format
Event status (0 = pending, 1 = completed)
List of tag names
Event location
Associated deal/lead ID
Associated funnel ID
ID of the user assigned to the event
Creation date in ISO 8601 format
Last update date in ISO 8601 format
Error responses
401Invalid or missing API keyapplication/json403Insufficient permissionsapplication/json429Rate limit exceededapplication/json