aventra.Developers
API referenceContacts

Add contact details

Add an email address, mobile number, telephone number or another contact detail.

Permissions: Contacts: read and write.

Behavior and retry rules

Email values must be valid email addresses. The other type requires a non-empty label. Each request adds a new contact detail, including duplicates. After a timeout, use GET points to check for the value before retrying; concurrent duplicate requests are not deduplicated.

POST/contacts/{id}/points

Authorization

bearerAuth
AuthorizationBearer <token>

Create a key in Aventra → Innstillinger → API-nøkler.

In: header

Path Parameters

id*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

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

application/json

curl -X POST "https://example.com/contacts/4d73dca4-7537-4f9c-924e-8bccd354663f/points" \  -H "Authorization: Bearer $AVENTRA_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "type": "email",    "value": "ola@example.com"  }'
{  "data": {    "id": 42,    "type": "email",    "label": "",    "value": "ola@example.com"  }}

See authentication, errors and retry guidance.