Before you start
- An API key. A workspace admin creates API keys in Settings → Integrations → API keys. The same keys work for both API versions. The steps for creating, managing, and expiring a key are in the API Integrations with Other Tools article linked above.
- The right permissions on the key. Each v2 request checks that the key has the Read or Write permission for the object it touches. A request without it is refused with an
insufficient_scopeerror.
Base URL and reference documentation
Send every v2 request to this base URL:- Interactive reference: api.reevo.ai/api/v2/public/docs
- OpenAPI specification: api.reevo.ai/api/v2/public/openapi.json
Authenticate your requests
Pass your API key as a bearer token in theAuthorization header:
X-Api-Key header used by the original API is also accepted, so an existing integration can switch its URLs to v2 without changing how it sends the key.
What you can do with v2
Custom objects use paths that start with
cus_obj__ followed by the object’s API name, for example /cus_obj__project. Every record also exposes its custom fields by their API names.
Find the fields for each object
Field names in v2 match each object’s schema in your workspace, including your custom fields. Two endpoints describe them:GET /_organization_schema_summarylists every object available in your workspace.GET /_schema/{record_type}describes one object’s fields, for exampleGET /_schema/contact.
Read records
Read a single record by its ID:POST to the object’s _query endpoint. You can filter, sort, and page through the results:
- Filters are a list of conditions with a
field, anoperator, and avalue. Combine conditions withand,or, andnot. Operators includeeq,ne,gt,gte,lt,lte,between,in,not_in,exists,not_exists,contains,starts_with,ends_with,contains_any, andcontains_none. - Page size is set with
limit, from 1 to 100. The default is 50. - Paging: each response includes a
paginationblock. To get the next page, send the same request withcursorset to thenext_cursorvalue from the previous response. Whennext_cursorisnull, you have reached the last page.
Create and update records
- Create a record with a
POSTto the object’s path, for examplePOST /contact. Put the fields in anattributesobject. - Update a record with a
PATCHto its path, for examplePATCH /contact/CONTACT_ID. Send only the fields you want to change. - Upsert a record with a
POSTto the object’s_upsertendpoint. Reevo looks for an existing record that matches thematchfield. If it finds one, it updates it and returns200. If it does not, it creates a new record and returns201.
jordan@example.com, or creates one if none exists:
Leave the matched field out of
attributes. Reevo applies the matched value automatically, and it cannot be changed in the same request.Handle errors
Every error response has the same shape, so your integration can branch on thecode field:
details object, for example the name of a field that does not exist. Common codes:
Request limits
Public API v2 requests count toward the same limits as the original API: a per-second speed limit and, depending on your plan, an allowance of requests for each billing period. Both apply to your whole organization. See API and MCP request limits for how the limits work and where to check your usage.Troubleshooting / FAQs
Do I need a new API key for v2?
Do I need a new API key for v2?
No. The same API keys work for both versions. Make sure the key has the Read or Write permissions for the objects you want to use.
Can I keep using the original API?
Can I keep using the original API?
Yes. The original API keeps working, and existing integrations built on it do not need to change. Its endpoints are documented in API Integrations with Other Tools.
Why is my query rejected when I filter on a field?
Why is my query rejected when I filter on a field?
v2 rejects a field that does not exist on the object instead of ignoring it. Check the exact field name with
GET /_schema/{record_type}, for example GET /_schema/contact.Can I read AI-generated summaries through the API?
Can I read AI-generated summaries through the API?
No. Neither API version returns Reevo’s AI-generated deal, meeting, or activity summaries.
Ready to connect? Open Reevo to create your API key.