> ## Documentation Index > Fetch the complete documentation index at: https://docs.sendora.ai/llms.txt > Use this file to discover all available pages before exploring further. # Send message to lead > Send a manual outbound message to a lead via SMS, Email, LinkedIn, or WhatsApp. Voice is not supported here, use the campaign API to place calls. The message is sent from the lead's existing conversation account for the channel, or the workspace's first active account when there is none. When a lead is enrolled in an active campaign, sending a manual message pauses the campaign for that lead to avoid conflicting outreach. This operation can change workspace data or trigger an external side effect; review the request before sending it and do not retry blindly after a timeout. ## OpenAPI ````yaml /openapi.json post /api/v1/public/conversations/{lead_id}/messages openapi: 3.1.0 info: description: >- Customer-facing API for managing outreach, leads, conversations, voice agents, knowledge bases, analytics, and webhooks. title: Sendora Public API version: 1.0.0 servers: - description: Production url: https://api.sendora.ai security: [] tags: - description: Build, launch, pause and stop campaigns, and enroll leads. name: Campaigns - description: Create, update, tag, enrich and import leads. name: Leads - description: Group leads into reusable lists. name: Lead lists - description: Find new prospects and research existing leads. name: Prospecting - description: Read conversations and send messages to leads. name: Inbox - description: Manage workspace-wide suppressions. name: Do not contact - description: Manage the content your agents answer from. name: Knowledge bases - description: Create, configure, test and publish voice agents. name: Voice agents - description: Give agents actions such as booking, lookups and transfers. name: Agent tools - description: Embed a voice agent on your website. name: Voice widgets - description: Start voice calls and read call results. name: Calls - description: Browse and preview the voices an agent can use. name: Voices - description: List numbers, bring your own, and route calls. name: Phone numbers - description: List the channel accounts connected to the workspace. name: Connected accounts - description: Register endpoints and review deliveries. name: Webhooks - description: Drive the workspace assistant programmatically. name: Copilot - description: Read workspace and campaign performance. name: Analytics - description: Track asynchronous operations. name: Jobs - description: Manage client workspaces, plans and branding. name: Agency paths: /api/v1/public/conversations/{lead_id}/messages: post: tags: - Inbox summary: Send message to lead description: >- Send a manual outbound message to a lead via SMS, Email, LinkedIn, or WhatsApp. Voice is not supported here, use the campaign API to place calls. The message is sent from the lead's existing conversation account for the channel, or the workspace's first active account when there is none. When a lead is enrolled in an active campaign, sending a manual message pauses the campaign for that lead to avoid conflicting outreach. This operation can change workspace data or trigger an external side effect; review the request before sending it and do not retry blindly after a timeout. operationId: public_send_message_api_v1_public_conversations__lead_id__messages_post parameters: - description: >- The lead's id: the `id` from List all leads. It is also the last part of that page's address in the app. in: path name: lead_id required: true schema: title: Lead Id type: string - in: header name: X-API-Key required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: Authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization requestBody: content: application/json: schema: $ref: '#/components/schemas/SendMessageBody' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/SendMessageResponse' description: Successful Response '400': description: >- The request is syntactically valid but cannot be processed with the supplied values. '401': description: The X-API-Key header is missing, invalid, expired, or revoked. '402': description: >- The workspace is suspended for billing, or the request would exceed a plan or usage limit. '403': description: >- The key is valid but lacks the required scope, or the workspace has no active plan, lacks the entitlement, or has this feature turned off or view-only. '404': description: >- The resource does not exist or is not owned by the authenticated workspace. '410': description: The workspace behind this key has been deleted. '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error '500': description: >- An unexpected Sendora error occurred. Retry only if the operation is safe to repeat. '503': description: >- An entitlement or billing check is temporarily unavailable. Retry after the Retry-After interval. security: - ApiKeyAuth: [] x-codeSamples: - label: cURL lang: bash source: >- curl -X POST 'https://api.sendora.ai/api/v1/public/conversations/YOUR_ID/messages' -H "X-API-Key: $SENDORA_API_KEY" -H "Content-Type: application/json" \ -d '{"channel":"EMAIL","content":"example"}' - label: Python lang: python source: >- import requests url = 'https://api.sendora.ai/api/v1/public/conversations/YOUR_ID/messages' headers = {'X-API-Key': '$SENDORA_API_KEY'} response = requests.post(url, headers=headers, json={'channel': 'EMAIL', 'content': 'example'}) response.raise_for_status() print(response.json()) - label: JavaScript lang: javascript source: >- const response = await fetch("https://api.sendora.ai/api/v1/public/conversations/YOUR_ID/messages", { method: "POST", headers: { 'X-API-Key': process.env.SENDORA_API_KEY, 'Content-Type': 'application/json' }, body: JSON.stringify({"channel": "EMAIL", "content": "example"}), }); if (!response.ok) throw new Error(await response.text()); console.log(await response.json()); - label: Go lang: go source: >- req, err := http.NewRequest("POST", "https://api.sendora.ai/api/v1/public/conversations/YOUR_ID/messages", bytes.NewBufferString(`{"channel": "EMAIL", "content": "example"}`)) if err != nil { log.Fatal(err) } req.Header.Set("X-API-Key", os.Getenv("SENDORA_API_KEY")) req.Header.Set("Content-Type", "application/json") resp, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer resp.Body.Close() components: schemas: SendMessageBody: properties: channel: $ref: '#/components/schemas/MessageChannel' description: Channel returned by the Sendora API. connection_id: anyOf: - maxLength: 128 type: string - type: 'null' deprecated: true description: >- Not used. The sending account is chosen automatically from the lead's existing conversation. Accepted for backward compatibility and ignored. title: Connection Id content: description: Content returned by the Sendora API. maxLength: 4096 minLength: 1 title: Content type: string required: - channel - content title: SendMessageBody type: object SendMessageResponse: properties: error: anyOf: - type: string - type: 'null' description: Error returned by the Sendora API. title: Error message_id: anyOf: - type: string - type: 'null' description: The id of the message that was sent or drafted. title: Message Id success: description: Success returned by the Sendora API. title: Success type: boolean required: - success title: SendMessageResponse type: object HTTPValidationError: properties: detail: description: Detail returned by the Sendora API. items: $ref: '#/components/schemas/ValidationError' title: Detail type: array required: [] title: HTTPValidationError type: object MessageChannel: enum: - EMAIL - LINKEDIN - WHATSAPP - SMS - VOICE title: MessageChannel type: string ValidationError: properties: loc: description: Loc returned by the Sendora API. items: anyOf: - type: string - type: integer title: Location type: array msg: description: Msg returned by the Sendora API. title: Message type: string type: description: Type returned by the Sendora API. title: Error Type type: string required: - loc - msg - type title: ValidationError type: object securitySchemes: ApiKeyAuth: description: Customer API key created in the Sendora dashboard. in: header name: X-API-Key type: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.