# Create a contact `POST /api/v1/lists/{list_id}/contacts` Adds a contact to the list. ## Permissions Send your API key in `X-API-Key`. Required permissions are **Lists → Write**. ## Headers - `X-Sport-Id` (integer, required) — The sport ID from [List sports](/api/sports/list.md). Use the sport the record belongs to. ## Path parameters - `list_id` (integer, required) — ID of the contact list. ## Body parameters - `firstname` (string or null) — Given name, up to 100 characters. Alias name. - `surname` (string or null) — Family name, up to 100 characters. - `company` (string or null) — Company or club name, up to 191 characters. - `email` (string or null) — Email address, up to 191 characters. Stored in lowercase. - `phone` (string or null) — Phone number, up to 32 characters. - `communication_consent` (boolean) — Whether the contact opted in. Defaults to false. Alias consent. - `is_active` (boolean) — Whether the contact is active. Defaults to true. Alias active. ## Request Set ASDINCLOUD_API_KEY and any variables named in the example before running it. ```sh curl --request POST \ --url "https://api.asdincloud.com/api/v1/lists/${LIST_ID:?Set LIST_ID}/contacts" \ --header "X-API-Key: $ASDINCLOUD_API_KEY" \ --header "X-Sport-Id: ${SPORT_ID:?Set SPORT_ID}" \ --header "Content-Type: application/json" \ --data '{"firstname":"Alex","surname":"Example","email":"alex@example.com","communication_consent":false}' ``` ## Response **201 Created** Returns the created contact in `data`. Example with fictional data and selected fields. ```json { "message_key": "entities.list_contact.messages.created", "data": { "id": 42, "list_id": 12, "firstname": "Alex", "surname": "Example", "company": null, "email": "alex@example.com", "phone": null, "communication_consent": 0, "is_active": 1, "imported_at": null, "tsc": 1794564000, "tsu": 1794564000 } } ``` ## Errors - `401` — The API key is missing or invalid. - `403` — The API key lacks the required permission. - `400` — Send the body as a JSON object. - `404` — The requested record was not found. - `422` — One or more fields failed validation.