Create an AI label and its rule
Creates the AI label and the plain language condition that applies it, in one call. The rule applies to emails synchronised after its creation. Setting autoReplyEnabled: true makes the inbox send replies on your behalf. In Emelia, AI features are paid with Emelia credits: each incoming email classified while the workspace has at least one rule, and each auto-draft, is debited from the Emelia account. Setting autoDraftEnabled or autoReplyEnabled to true never returns 402 PLAN_REQUIRED in Emelia. Supports Idempotency-Key.
Authorization
apiKey Your 48 character Emelia API key, the same as for the Emelia API, sent as is (a Bearer prefix is tolerated). Create it at https://v3.emelia.io/settings/api. Disabling a key can take up to 5 minutes to apply to the Inbox API.
In: header
Header Parameters
Any unique string (a UUID). The first successful response is stored 24 hours and replayed with Idempotent-Replay: true for the same key, method, URL and body. Same key with another body: 409 CONFLICT. Original call still running: 409 CONFLICT. Failed calls (status 400 and above) release the key. Keys are scoped to the workspace, not to the API key: two integrations of the same workspace must not reuse values. Replays count in the quotas.
length <= 255Request 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
curl -X POST "https://example.com/ai-label-rules" \ -H "Authorization: YOUR_API_KEY" \ -H "Idempotency-Key: 3f6c1b2e-7d4a-4f0e-9a51-acme00000001" \ -H "Content-Type: application/json" \ -d '{ "name": "Interested", "color": "#2563eb", "condition": "The prospect shows interest: asks for a call, a demo, pricing or more information.", "autoDraftEnabled": true }'{ "rule": { "id": "cmrlacme0000000000000001", "label": { "id": "cmtgacme0000000000000002", "name": "Interested", "color": "#2563eb", "isAiLabel": true }, "condition": "The prospect shows interest: asks for a call, a demo, pricing or more information.", "autoDraftEnabled": true, "autoReplyEnabled": false, "autoReplyConfidenceThreshold": 85, "autoReplyDelayMinutes": 0, "autoReplyNotifyOnSend": true, "hideFromInbox": false, "createdAt": "2026-10-01T10:05:00.000Z", "updatedAt": "2026-10-02T16:40:00.000Z" }}