Nextora / Développeurs
Votre espace de travail,
programmable.
A REST API for contacts, companies, deals, tasks and leads. Signed webhooks for every change, whether it came from the app, the API, a workflow or an import. An MCP server for AI clients. Every example on these pages uses your workspace.
https://.nextora.co/api/v1
Type your workspace — every example follows.
- Version2026-10-10
- Spéc.OpenAPI 3.1
- Limite500 req/min
GET/api/v1/deals
curl -G https://acme.nextora.co/api/v1/deals \
-H "Authorization: Bearer $NEXTORA_API_KEY" \
-d status=in_progress \
-d limit=1Response200 OK
{
"data": [
{
"id": "8f2d6c1a-4b7e-4f0a-9c3d-2e1b5a6f7c80",
"title": "Northwind Analytics — annual plan",
"value": 24000,
"currency": "EUR",
"status": "in_progress",
"stage": {
"name": "Proposal",
"type": "open"
},
"expected_close_date": "2026-11-27"
}
],
"meta": {
"limit": 1,
"has_more": true,
"next_cursor": "eyJpZCI6IjhmMmQ2YzFhIn0"
}
}Commencer ici
Le démarrage rapide en cinq minutes- 01Créer une cléSettings → Developers → API keys. Pick only the scopes you need; the key is shown once.
- 02Faire une demandeSend it as a bearer token. Lists page with cursors; errors carry a stable code.
- 03À l’écoute des changementsDes événements signés pour chaque modification — depuis l’application, l’API, les workflows et les imports.
Référence de l’API
Télécharger la spécification OpenAPI- Contacts Personnes, leur entreprise, responsable, tags et champs personnalisés.
/api/v1/contacts - Companies Organisations, avec secteur, taille et responsable.
/api/v1/companies - Deals Valeur, étape, catégorie de prévision, gagnée et perdue.
/api/v1/deals - Pipelines Pipelines et étapes avec probabilités.
/api/v1/pipelines - Tâches Des tâches avec statut, priorité, dates et sous-tâches.
/api/v1/tasks - Leads L’intérêt entrant, avec statut, source et score.
/api/v1/leads - Notes Notes sur les contacts, les entreprises, les affaires et les leads.
/api/v1/notes - Utilisateurs Utilisateurs de l'espace, pour attribuer les responsables.
/api/v1/users - Champs personnalisés Les définitions des champs personnalisés par type d’enregistrement.
/api/v1/custom-fields - Forecast Totaux du pipeline par catégorie de prévision.
/api/v1/forecast - Webhook subscriptions Abonnements, envois, nouvelles tentatives et secrets.
/api/v1/webhooks
Conventions
Les mêmes règles sur chaque point d’accès, pour qu’un seul client fonctionne partout.
- URL de base
https://{workspace}.nextora.co/api/v1— custom domains work the same.- Authentification
Authorization: Bearer sk_live_…, with scopes. A key acts as its owner.- Format
- JSON in and out, snake_case, ISO 8601 timestamps in UTC.
- Erreurs
- One shape everywhere:
code,message,details,request_id. - Pagination
- Cursors:
limitup to 100 andmeta.next_cursor. - Limites de débit
- 500 requests a minute per key, with headers on every response.
- Idempotence
Idempotency-Keyon POST replays the original response for 24 hours.- Gestion des versions
- Version
2026-10-10. Breaking changes only with 90 days’ notice.
Au-delà de REST
- Webhooks Twenty events, signed with HMAC-SHA256, retried automatically when your endpoint fails.
- Serveur MCP Claude, ChatGPT et Cursor sur votre espace de travail, via OAuth 2.1.
- Webhooks de workflow Lancez un workflow depuis n’importe quel système avec un seul POST.
- Formulaires web Intégrez dans le CRM, comme leads, les envois des formulaires de votre propre site.