---
title: "POST /"
method: POST
path: "/"
tags: ["Channel Adapter Services"]
---

# POST /

`POST /`

## Request

- Base URL: `https://adapter-gateway.example.com`
- URL: `https://adapter-gateway.example.com/`
- Auth: none declared

The API endpoint implemented by the Channel Adapter to accept messages from Medallia Conversations.

## Query parameters

- `access_token` string, required

## Request body

- union
  - OutboundMessageRequest
    - `recipient` object, required
      - `id` string, required: An identifier unique to the customer, such as phone number, email, or another channel-specific value. For phone numbers, the identifier must be in E.164 format.
    - `message` object, required
      - `text` string, required: The text of the question being asked.
      - `quick_replies` object[]: Optional array of objects containing the response options.
        - `content_type` 'text': The type of the payload field.
        - `title` string: Text of a response option to the question.
        - `payload` string, uuid: Unique identifier of the quick reply option. The adapter can send this as the user's response, when the quick reply option is chosen.
        - `image_url` string, uri
      - `attachments` object[]: An optional array containing files or a location object attached to the message.
        - `type` 'file' | 'audio' | 'image' | 'video' | 'location', required: The type of the attachment.
        - `payload` object, required
          - `url` string, uri: The attachment url.
          - `data` string, byte: The attached file content.
          - `metadata` object: If data was provided instead of url, this object should include the MIME type and extension of the attachment.
            - `mime` string, required
            - `extension` string, required: The attachment file extension.
          - `coordinates` object
            - `lat` number, float, required
            - `long` number, float, required
    - `notification_type` 'REGULAR' | 'CUSTOM', required
  - EndOfConversationSignal
    - `recipient` object, required
      - `id` string: An identifier unique to the customer, such as phone number, email, or another channel-specific value. For phone numbers, the identifier must be in E.164 format.
    - `sender_action` 'conversation_ended', required
    - `reason` string, required: The reason the conversation has ended.

## Response `200`

A successful response includes the customer and message IDs.

- OutboundMessageResponse
  - `recipient_id` string, required: The identifier for the recipient, as sent in the original request.
  - `message_id` string, uuid, required: A unique identifier for the message, assigned by the channel adapter.

## Other responses

- `401`: Unauthorized.

---

[API](https://skmtc.dev/medallia/apis/conversations-api.md) - [All operations](https://skmtc.dev/medallia/apis/conversations-api/llms.txt) - [OpenAPI document](https://skmtc.dev/medallia/apis/conversations-api/revisions/013191364319?raw)