Create a contact
Create a person in your workspace. Add email/phone details and company relationships with the separate endpoints below.
Permissions: Contacts: read and write.
Behavior and retry rules
Save a UUID in your integration before sending this request. A reused ID returns 409; GET the contact to check whether an earlier request succeeded. A name or email address is not a unique contact identifier. This request does not create company links or contact details.
/contactsAuthorization
bearerAuth Create a key in Aventra → Innstillinger → API-nøkler.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/contacts" \ -H "Authorization: Bearer $AVENTRA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "id": "56741677-c630-43a3-a7b0-cb88ee639675", "name": "Ola Nordmann", "notes": "Interested in a product demo." }'{ "data": { "id": "56741677-c630-43a3-a7b0-cb88ee639675", "name": "Ola Nordmann", "notes": "Interested in a product demo.", "created_at": "2026-09-05T10:00:00Z" }}See authentication, errors and retry guidance.