Conversations

Attach a label to a conversation

Attach an organization label to an inbox conversation. The label and conversation must belong to compatible team scope; duplicate attachment is idempotent.

post/{phone_number_id}/conversations/{id}/labels

Request

  • Base URL: https://api.kirimdev.com/v1
  • URL: https://api.kirimdev.com/v1/{phone_number_id}/conversations/{id}/labels
  • Auth: HTTP bearer

Path parameters

phone_number_idstring required

Meta WhatsApp Business phone_number_id of the connected account that should send / own this resource. Discoverable via GET /v1/accounts (returned as phone_number_id on each row).

Example:106540352242922
idstring required

Public Kirimdev conversation ID.

Example:cnv_01HXYZABCDEFGHJKMNPQRSTVWX

Headers

Idempotency-Keystring

Optional retry key. Reusing the same key with the same method, path, and body within 24 hours returns the original response; reusing it for a different request returns 422.

Example:order-20260910-0001

Request body

label_idstring required

Response

Attached

request_idstring required

Unique request identifier to include when contacting support.

Example response

{
  "request_id": "req_01HXYZABCDEFGHJKMNPQRSTVWX"
}

Changes

No recorded changes to this operation across all 1 revision of this API.