Share via


Sinch (Preview)

Sinch SMS delivers your business SMS alerts, notifications, invites, marketing messages and more. The Sinch MessageMedia, Sinch Engage, One NZ, eTXT, and Grouptext platforms powers billions of messages worldwide and with this connector is integrating into your tools for enhanced business communications.

This connector is available in the following products and regions:

Service Class Regions
Copilot Studio Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Support channel
URL https://messagemedia.com/contact/
Email support@messagemedia.com
Connector Metadata
Publisher Sinch Sweden AB
Website https://messagemedia.com
Privacy policy https://messagemedia.com/legal/privacy-policy/
Categories Communication

Your Connector Name

Sinch

API documentation

https://messagemedia.github.io/documentation/#tag/Messages/operation/SendMessages

Supported Operations

https://support.messagemedia.com/hc/en-us/categories/10710547404559-Power-Automate-App-Support

How to get credentials

This connector uses API Key and API secret authentication (see steps in bellow link on how to obtain one) https://support.messagemedia.com/hc/en-us/articles/4413627066383-Creating-New-API-Credentials

Supported Operations

This connector supports the following operations:

  • Send Text Message (SMS): Send a text message to multiple mobile recipients.
  • Get sender IDs: This action will return a list of sender IDs linked to your account.
  • Get message status: Get a message status using message ID
  • When receiving an incoming text message (SMS): This operation triggers when you receive an incoming text message (SMS).
  • When receiving a delivery receipt: This operation triggers when you receive an delivery receipt for an outbound text message (SMS).

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
api_key securestring The api_key for this api True
api_secret securestring The api_secret for this api True
Sinch services string Sinch services True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Get message status

Get a message status using message ID

Get sender IDs

This action will return a list of sender IDs linked to your account.

Send Text Message (SMS)

Specify the details of your SMS message

Get message status

Get a message status using message ID

Parameters

Name Key Required Type Description
Unique ID of this message
messageId True string

Unique ID of this message

Returns

Body
message

Get sender IDs

This action will return a list of sender IDs linked to your account.

Returns

Name Path Type Description
page
pagination.page integer

page

page_size
pagination.page_size integer

page_size

total_count
pagination.total_count integer

total_count

page_count
pagination.page_count integer

page_count

type
default_sender.type string

type

number
default_sender.number string

number

source_type
default_sender.source_type string

source_type

mms_capable
default_sender.mms_capable boolean

mms_capable

senders
senders array of object

senders

display_type
senders.display_type string

display_type

is_default
senders.is_default boolean

is_default

label
senders.label string

label

mms_capable
senders.mms_capable boolean

mms_capable

number
senders.number string

number

number_id
senders.number_id string

number_id

source_type
senders.source_type string

source_type

type
senders.type string

type

number_status
senders.number_status string

number_status

account_id
account_id string

account_id

vendor_id
vendor_id string

vendor_id

Send Text Message (SMS)

Specify the details of your SMS message

Parameters

Name Key Required Type Description
Sender Id
source_number string

Specify a source number to be used

Destination Number
to True string

Recipient's mobile number in E.164 format

Message
message True string

SMS message body

Delivery report
delivery_report boolean

Delivery reports can be requested with each message. If delivery reports are requested, a webhook will be submitted to the callback_url property specified for the message (or to the webhooks)

Callback url
callback_url string

A URL can be included with each message to which Webhooks will be pushed to via a HTTP POST request

Metadata key
metadata_key string

metadata key

Metadata value
metadata_value string

metadata value

Returns

Name Path Type Description
messages
messages array of object

messages

callback_url
messages.callback_url string

callback_url

delivery_report
messages.delivery_report boolean

Delivery reports can be requested with each message. If delivery reports are requested, a webhook will be submitted to the callback_url property specified for the message (or to the webhooks)

destination_number
messages.destination_number string

destination number

format
messages.format string

format

message_expiry_timestamp
messages.message_expiry_timestamp string

message expiry timestamp

message_flags
messages.message_flags array of

message flags

message_id
messages.message_id string

message id

Source
messages.metadata.Source string

Source

scheduled
messages.scheduled string

scheduled

status
messages.status string

status

content
messages.content string

content

source_number
messages.source_number string

source number

media
messages.media array of string

media

subject
messages.subject string

subject

Triggers

When receiving a delivery receipt

This operation triggers when you receive an delivery receipt for an outbound text message (SMS).

When receiving an incoming text message (SMS)

This operation triggers when you receive an incoming text message (SMS).

When receiving a delivery receipt

This operation triggers when you receive an delivery receipt for an outbound text message (SMS).

Returns

Name Path Type Description
message_id
message_id string

ID of the original message

status
status string

Delivery Reports indicate message status

source_address
source_address string

source address

destination_address
destination_address string

destination address

content
content string

content

type
type string

type

delivery_report_id
delivery_report_id string

delivery report id

status_code
status_code string

Status codes provide more granular insight into a message's status

submitted_date
submitted_date string

Message Timestamp

date_received
date_received string

Provider Timestamp

Attachments
attachments array of object

Attachments

Attachment type
attachments.attachment_type string

Attachment type

Attachment content
attachments.attachment_content string

Attachment content

Attachment name
attachments.attachment_name string

Attachment name

Metadata
metadata array of object

Any metadata that was included in the original submit message

Metadata key
metadata.metadata_key string

Metadata key

Metadata value
metadata.metadata_value string

Metadata value

When receiving an incoming text message (SMS)

This operation triggers when you receive an incoming text message (SMS).

Returns

Name Path Type Description
message_id
message_id string

ID of the original message

reply_id
reply_id string

A unique ID for the reply that this notification represents

status
status string

Delivery Reports indicate message status

source_address
source_address string

source address

destination_address
destination_address string

destination address

content
content string

The content of the reply

type
type string

type

status_code
status_code string

Status codes provide more granular insight into a message's status

submitted_date
submitted_date string

Message Timestamp

date_received
date_received string

Provider Timestamp

Attachments
attachments array of object

A list containing all the attachments that were included in the reply. This field is present only if you have enabled Inbound MMS in your account and the reply contains attachments

Attachment type
attachments.attachment_type string

The MIME type associated with this attachment

Attachment content
attachments.attachment_content string

The attachment Base64 encoded

Attachment name
attachments.attachment_name string

The name of the attachment

Metadata
metadata array of object

Any metadata that was included in the original submit message request

Metadata key
metadata.metadata_key string

Metadata key

Metadata value
metadata.metadata_value string

Metadata value

Definitions

message

Name Path Type Description
callback_url
callback_url string

A URL can be included with each message to which Webhooks will be pushed to via a HTTP POST request

delivery_report
delivery_report boolean

Delivery reports can be requested with each message. If delivery reports are requested, a webhook will be submitted to the callback_url property specified for the message (or to the webhooks)

destination_number
destination_number string

The destination number the message should be delivered to

format
format string

The format specifies which format the message will be sent as, SMS (text message), MMS (multimedia message) or TTS (text to speech)

message_expiry_timestamp
message_expiry_timestamp string

A message expiry timestamp can be provided to specify the latest time at which the message should be delivered

message_flags
message_flags array of

message_flags

message_id
message_id string

Message id

Source
metadata.Source string

Source

scheduled
scheduled string

Scheduled delivery date time of the message

status
status string

The status of the message

content
content string

content

source_number
source_number string

source number

media
media array of string

media

subject
subject string

subject