---
title: "Send Message"
method: POST
path: "/v2/notification"
tags: ["Notification"]
---

# Send Message

`POST /v2/notification`

This endpoint allows you to send a new Notification depending on the type of communication channel. you want to send (SMS, Email, RCS, WhatsApp).The channel parameter allows us to differentiate the type of communication channel between SMS, WhatsApp, Email, or RCS. That's why only this endpoint is used for the send of Notification because the channel help us to send each type of communication channel.

## Request body

- union
  - EmailMessage
    - `channel` 'EMAIL', required — delivery method, must be one of: SMS, EMAIL, WHATSAPP, RCS
    - `callbacks` string[] — URL Array to send event notifications
    - `request` EmailRequest, required — Email request
      - `message` string — Text to send
      - `clientId` string — Client id associated with registry
      - `externalId` string — Allows you to use a custom ID for tracing your Notifications.
      - `to` string, required — Recipient that receives the message
      - `from` string, required — Email address that delivers the message
      - `subject` string, required — Email subject
  - SmsMessage
    - `channel` 'SMS', required — delivery method, must be one of: SMS, EMAIL, WHATSAPP, RCS
    - `callbacks` string[] — URL Array to send event notifications
    - `request` SmsRequest, required — sms request
      - `message` string — Text to send
      - `clientId` string — Client id associated with registry
      - `externalId` string — Allows you to use a custom ID for tracing your Notifications.
      - `to` string, required — Recipient that receives the message
      - `from` string, required — Code where the message was sent
  - RcsMessage
    - `channel` 'RCS', required — delivery method, must be one of: SMS, EMAIL, WHATSAPP, RCS
    - `callbacks` string[] — URL Array to send event notifications
    - `request` RcsRequest, required — Rcs request
      - `message` string — Text to send
      - `clientId` string — Client id associated with registry
      - `externalId` string — Allows you to use a custom ID for tracing your Notifications.
      - `to` string, required — Recipient that receives the message
      - `title` string
      - `agentId` string, required — Unique identifier of the agent
      - `messageType` 'TEXT' | 'STANDALONECARD', required — message Type
      - `suggestions` Suggestion[] — List of suggestions
        - `type` 'REPLY'
        - `text` string
      - `cardImageUrl` string — cardImageUrl
      - `mediaHeight` 'SHORT' | 'MEDIUM' | 'TALL' — The height of the media within a rich card with a vertical layout. For a standalone card with horizontal layout, height is not customizable, and this field is ignored.
      - `cardOrientation` 'HORIZONTAL' | 'VERTICAL' | 'CARD_ORIENTATION_UNSPECIFIED' — Orientation of the card
      - `alignment` 'LEFT' | 'RIGHT' | 'THUMBNAIL_IMAGE_ALIGNMENT_UNSPECIFIED' — Image preview alignment for standalone cards with horizontal layout
  - WhatsappMessage
    - `channel` 'WHATSAPP', required — delivery method, must be one of: SMS, EMAIL, WHATSAPP, RCS
    - `callbacks` string[] — URL Array to send event notifications
    - `request` WhatsappRequest, required — WhatsApp request
      - `message` string — Text to send
      - `clientId` string — Client id associated with registry
      - `externalId` string — Allows you to use a custom ID for tracing your Notifications.
      - `to` string, required — Recipient that receives the message
      - `from` string, required — Message origin. Address of the origin senderId.
      - `placeholders` object — Placeholder values to personalize message templates. Required when sending through message templates that have placeholders.
      - `templateName` string — Name of the WhatsApp message template used for this message. Required when sending message templates.
      - `templateLanguage` string — Language code of the WhatsApp message template used for this message. Required for languages other than en_US.
      - `type` string — Message type
      - `caption` string — Message caption
      - `contacts` Contact[] — Contact info
        - `addresses` AddresContact[]
          - `city` string
          - `country` string
          - `country_code` string
          - `state` string
          - `street` string
          - `type` string
          - `zip` string
        - `birthday` string
        - `emails` EmailContact[]
          - `email` string
          - `type` string
        - `org` OrgContact
          - `company` string
          - `department` string
          - `title` string
        - `phones` PhoneContact[]
          - `phone` string
          - `type` string
        - `urls` UrlContact[]
          - `url` string
          - `type` string
        - `name` ContactName
          - `first_name` string
          - `formatted_name` string
          - `last_name` string
          - `suffix` string
      - `location` Location — Location info
        - `longitude` string
        - `latitude` string
        - `name` string
        - `address` string
      - `interactive` Interactive — Interactive info
        - `type` string
        - `body` Body — An object with the body of the message.
          - `text` string
        - `header` Header — Header content displayed on top of a message
          - `type` string
          - `text` string
          - `document` Document
            - `link` string
          - `video` Video
            - `link` string
          - `image` Image
            - `link` string
        - `footer` Footer — An object with the footer of the message.
          - `text` string
        - `action` Action — An action object with what you want the user to perform after reading the message
          - `buttons` Button[]
            - `type` string
            - `reply` Reply
              - …
          - `button` string
          - `sections` Section[]
            - `title` string
            - `rows` RowSection[]
              - …
          - `name` string
          - `parameters` FlowParameters
            - `flowMessageVersion` string, required
            - `flowToken` string
            - `flowId` string, required
            - `flowCta` string, required
            - `flowAction` string
            - `flowActionPayload` FlowActionPayload
              - …
      - `replyTo` string — reply to message id
      - `fileName` string — File name only applies to document type message
      - `templateHeader` union — Optional message template header info
        - object
          - `type` 'text', required — Header type
          - `text` string, required — Header text placeholder value
        - object — Media Message Template Header. Used to add images, documents or video to message templates.
          - `type` 'image' | 'document' | 'video', required — Header type
          - `url` string, required — Link to a media file (image, document or video)
      - `templateId` string — ID of the WhatsApp message template used for this message
      - `cards` CarouselCard[] — Optional carousel cards info
        - `templateHeader` CarouselTemplateHeader, required — Carousel message template header. Only image or video types are allowed
          - `type` 'image' | 'video', required — Header type
          - `url` string, required — Link to a media file (image or video)
        - `placeholders` object — Placeholder values to personalize message templates for this card
        - `cardIndex` integer, required — Card index in the carousel
        - `templateButtons` CarouselTemplateButtons[] — Optional message template buttons info for this card (cta or quick-reply only, max 2 buttons total across message template Buttons)
          - `type` 'cta' | 'quick-reply', required — Button type
          - `values` ButtonValue[]
            - `index` integer, required — Button index position
            - `value` string — Button value/text. Required for regular buttons, optional for flow buttons
      - `templateButtons` TemplateButtons[] — Optional message template button info
        - `type` 'cta' | 'quick-reply' | 'flow', required — Button type
        - `values` ButtonValue[]
          - `index` integer, required — Button index position
          - `value` string — Button value/text. Required for regular buttons, optional for flow buttons

## Response `202`

Accepted the request to send the notification

- BaseResponse
  - `meta` MetadataDTO
    - `timestamp` integer, required — Transaction's date in timestamp
    - `transactionId` string, required — Id for the current transaction (Endpoint's call)
    - `explain` string — Explain string in case of failure

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Invalid email origin, must be a valid email sender
- `410` — Token expired
- `429` — Too Many Requests
- `500` — Internal server error

---

[API](https://skmtc.dev/messangi/apis/raven.md) · [All operations](https://skmtc.dev/messangi/apis/raven/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/messangi/raven/revisions/c87f398fa338/schema)