# Create a conversation



URL: https://getclickfix.com/docs/api-reference/conversations/create-a-conversation?lang=en

Scope: `conversations:write`. Give the contact as `contact_uuid` or, with your own user id, as `contact_external_id`. Contact and channel (`inbox_uuid`) must belong to the key's organization and the channel must be active. On a web widget channel the contact sees the conversation once they sign in on your site with `identify`. The conversation is assigned to the member who created the key. `Idempotency-Key` is required.

This page is the API reference generated from the OpenAPI schema; request and response schemas, examples and curl/Node.js/Go/PHP requests are on the HTML page. Shared rules: https://getclickfix.com/docs/api.md?lang=en