PUT
/contactsPUT /contacts
Upsert a contact by email: create it, or merge the payload into the existing record.
Request
curl -X PUT 'https://api.sendheron.com/api/v1/contacts' \
-H 'Authorization: Bearer <YOUR_API_KEY>' \
-H 'Content-Type: application/json'Required scopes
The key must carry these:
- contacts:write
Body parameters
| Name | Type | Required | Description |
|---|---|---|---|
| string | Yes | Match key for the upsert. | |
| firstName | string | No | First name. |
| lastName | string | No | Last name. |
| properties | object | No | Custom fields, merged into any existing properties. |
| tagNames | string[] | No | Tags to attach by name. |
Responses
Returns 200 on success. Errors use standard HTTP status codes: 401 for a missing or invalid key, 403 when the key lacks a required scope, 404 for an unknown id, and 429 when a rate limit window is exhausted.
Rate limits
60 per minute, 150 per 5 minutes, 300 per hour, 2000 per day. All windows apply at once, and the tightest one you breach is the one that rejects the request.