Add a company or person to a list
You send only the reference; the name is resolved from the register. Adding an
entity that is already on the list returns 409 with the existing item's id.
Free.
Authorization
bearerAuth Your API key, sent as Authorization: Bearer rc_live_….
In: header
Path Parameters
The list's id.
uuidHeader Parameters
Makes a retry safe. A request repeated with the same key within 24 hours returns
the first response (with Idempotent-Replayed: true) instead of acting twice.
Reusing a key with a different body returns 422; retrying while the first
request is still running returns 409. Use a random UUID.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
An entity to add. Send only its type and id.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/lists/497f6eca-6276-4993-bfeb-53cbbbba6f08/items" \ -H "Content-Type: application/json" \ -d '{ "entity": { "object": "company", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08" } }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "object": "list_item", "list_id": "430bbdbc-9d7f-4d06-a273-67ca4ba4ae4b", "entity": { "object": "company", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string" }, "note": "string", "created_at": "2019-08-24T14:15:22Z"}