Release Candidate — the API is undergoing final validation before general availability, and minor changes may still occur.
Hellomateo API Documentation
DocumentationAPI Reference
Working with the API

Limits

Rate limits

We do not currently apply rate limits to calls to our API. As usage evolves, we may introduce limits to provide equitable access for everyone and prevent abuse. We encourage your feedback and will announce any future limits or changes before they take effect.

Payload size limits

Most API request bodies are limited to 1 MB (1,048,576 bytes). JSON request bodies sent to the following batch import endpoints are limited to 5 MB (5,242,880 bytes):

  • POST /v1/contacts/imports/batch
  • POST /v1/deals/imports/batch
  • POST /v1/appointments/imports/batch

Requests that exceed these limits return 413 Payload Too Large with the error code PAYLOAD_TOO_LARGE. For larger imports, upload a CSV or JSON file and submit its File ID instead. See Contact and entity batch imports for details.

Request IDs

Use request IDs from response headers and error responses when debugging API requests.

Setting up Legacy Webhooks

Configure webhooks that use the legacy event and payload contract.

On this page

Rate limits
Payload size limits