Create a task
tenantKeybearerAuthX-Tenant-Key<token>The public store key (pk_live_…). Required on every call.
AuthorizationBearer <token>A customer token from POST /v1/auth/login, or a merchant API key, on routes that need one.
X-Client-IP?stringOptional. IP address of the shopper (one IPv4/IPv6, no port, no list). Honoured only together with a valid X-Tenant-Secret; ignored otherwise. Used for rate limits and recorded with form submissions.
X-Tenant-Secret?stringOptional here. Server secret of the store: server-to-server only, never from a browser. Enables X-Client-IP.
Idempotency-Key?stringOptional; recommended (a UUID made once per user action, reused only to retry that action). Only a success is stored (24 hours): the same key with the same body, URI and credentials (Authorization, X-Cart-Token, X-Chat-Token) replays it (Idempotent-Replayed: true); anything else under that key is 422 IDEMPOTENCY_KEY_REUSED. An error is never stored: after a 4xx or 5xx, retrying with the same key runs the request again.
application/json- body
POST merchant/crm/tasks and PATCH merchant/crm/tasks/{id}. The shape only; the tasks service validates the rest (a recurring task
needs a due date, an unknown assignee, a record that does not exist) with a 422.
due_date + due_time an all-day task (no time) or a timed one, in the store's timezone due_at or a moment (ISO-8601), a timed task; null clears the due date records the whole set of records it is about: ["contact:12", "company:3"]
title*stringlength <= 200notes?|length <= 10000type?stringlength <= 32priority?integer0 <= value <= 2due_date?|datedue_time?string|nulldue_at?|date-timeassignee_id?|1 <= valuequeue?|length <= 64repeat_rule?|length <= 32repeat_interval?integer1 <= value <= 365repeat_from?stringlength <= 32records?array<>items <= 20Success.
application/json- response
data*curl -X POST 'https://api.elaraone.app/api/v1/merchant/crm/tasks' \ -H 'X-Tenant-Key: pk_live_…' \ -H 'X-Tenant-Secret: your-server-secret' \ -H 'Content-Type: application/json' \ -d '{ "title": "string"}'{ "data": { "id": 0, "title": "string", "notes": "string", "type": "string", "priority": 0, "status": "string", "due_at": "string", "due_all_day": true, "assignee_id": 0, "queue": "string", "records": [ "string" ], "repeat_rule": "string", "repeat_interval": 0, "repeat_from": "string", "next_task_id": 0, "created_by": { "type": "string" }, "completed_at": "string", "cancelled_at": "string", "created_at": "string", "updated_at": "string" }}