Send SMS with Sinch through Courier

Prerequisites

A Sinch account
Your Sinch Service Plan ID and API token
An SMS-capable from number in Sinch

Setup

Get your Sinch credentials

In Sinch, open the dashboard and copy your Service Plan ID and API token.

Configure in Courier

Open the in Courier, enter your Service Plan ID, API token, and from number, then click “Save.”

Addressing a recipient and sending are the same on every SMS provider, so they are documented once: and .

Overrides

covers the two levels and which one wins. Overrides change the request body and config Courier sends to Sinch. Override apiToken, servicePlanId, and url via config, and any message body field via body.

const { requestId } = await courier.send.message({
  message: {
    template: "nt_01kx4h2jdafq8bk9aftxak4b40",
    to: {
      phone_number: "+12345678901",
    },
    providers: {
      sinch: {
        override: {
          body: {
            from: "+15555555555",
          },
          config: {
            apiToken: "<override API token>",
            servicePlanId: "<override Service Plan ID>",
            url: "<alternate API url>",
          },
        },
      },
    },
  },
});

response = client.send.message(
    message={
        "template": "nt_01kx4h2jdafq8bk9aftxak4b40",
        "to": {
            "phone_number": "+12345678901",
        },
        "providers": {
            "sinch": {
                "override": {
                    "body": {
                        "from": "+15555555555",
                    },
                    "config": {
                        "apiToken": "<override API token>",
                        "servicePlanId": "<override Service Plan ID>",
                        "url": "<alternate API url>",
                    },
                },
            },
        },
    },
)

curl -X POST https://api.courier.com/send \
  -H "Authorization: Bearer $COURIER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": {
      "template": "nt_01kx4h2jdafq8bk9aftxak4b40",
      "to": {
        "phone_number": "+12345678901"
      },
      "providers": {
        "sinch": {
          "override": {
            "body": {
              "from": "+15555555555"
            },
            "config": {
              "apiToken": "<override API token>",
              "servicePlanId": "<override Service Plan ID>",
              "url": "<alternate API url>"
            }
          }
        }
      }
    }
  }'

response = courier.send_.message(
  message: {
    template: "nt_01kx4h2jdafq8bk9aftxak4b40",
    to: {
      phone_number: "+12345678901"
    },
    providers: {
      sinch: {
        override: {
          body: {
            from: "+15555555555"
          },
          config: {
            apiToken: "<override API token>",
            servicePlanId: "<override Service Plan ID>",
            url: "<alternate API url>"
          }
        }
      }
    }
  }
)

response, err := client.Send.Message(context.TODO(), courier.SendMessageParams{
	Message: courier.SendMessageParamsMessage{
		To: courier.SendMessageParamsMessageToUnion{
			OfUserRecipient: &shared.UserRecipientParam{
				PhoneNumber: courier.String("+12345678901"),
			},
		},
		Template: courier.String("nt_01kx4h2jdafq8bk9aftxak4b40"),
		Providers: shared.MessageProvidersParam{
			"sinch": shared.MessageProvidersTypeParam{
				Override: map[string]any{
					"body": map[string]any{
						"from": "+15555555555",
					},
					"config": map[string]any{
						"apiToken": "<override API token>",
						"servicePlanId": "<override Service Plan ID>",
						"url": "<alternate API url>",
					},
				},
			},
		},
	},
})

SendMessageParams params = SendMessageParams.builder()
    .message(SendMessageParams.Message.builder()
        .to(UserRecipient.builder().phoneNumber("+12345678901").build())
        .template("nt_01kx4h2jdafq8bk9aftxak4b40")
        .providers(MessageProviders.builder()
            .putAdditionalProperty("sinch", JsonValue.from(java.util.Map.of("override", java.util.Map.of(
                    "body", java.util.Map.of(
                        "from", "+15555555555"
                    ),
                    "config", java.util.Map.of(
                        "apiToken", "<override API token>",
                        "servicePlanId", "<override Service Plan ID>",
                        "url", "<alternate API url>"
                    )
                ))))
            .build())
        .build())
    .build();
SendMessageResponse response = client.send().message(params);

$response = $client->send->message(
  message: [
    'template' => 'nt_01kx4h2jdafq8bk9aftxak4b40',
    'to' => [
      'phone_number' => '+12345678901',
    ],
    'providers' => [
      'sinch' => [
        'override' => [
          'body' => [
            'from' => '+15555555555',
          ],
          'config' => [
            'apiToken' => '<override API token>',
            'servicePlanId' => '<override Service Plan ID>',
            'url' => '<alternate API url>',
          ],
        ],
      ],
    ],
  ],
);

SendMessageParams parameters = new()
{
    Message = new()
    {
        To = new UserRecipient { PhoneNumber = "+12345678901" },
        Template = "nt_01kx4h2jdafq8bk9aftxak4b40",
        Providers = new Dictionary<string, MessageProvidersType>()
        {
            {
                "sinch",
                new()
                {
                    Override = JsonSerializer.Deserialize<Dictionary<string, JsonElement>>(
                        """
                        {
                          "body": {
                            "from": "+15555555555"
                          },
                          "config": {
                            "apiToken": "<override API token>",
                            "servicePlanId": "<override Service Plan ID>",
                            "url": "<alternate API url>"
                          }
                        }
                        """
                    ),
                }
            },
        },
    },
};

var response = await client.Send.Message(parameters);

courier send message \
  --api-key "$COURIER_API_KEY" \
  --message.to '{"phone_number": "+12345678901"}' \
  --message.template nt_01kx4h2jdafq8bk9aftxak4b40 \
  --message.providers '{"sinch": {"override": {"body": {"from": "+15555555555"}, "config": {"apiToken": "<override API token>", "servicePlanId": "<override Service Plan ID>", "url": "<alternate API url>"}}}}'

With Courier MCP, send my template to +12345678901 through Sinch with a different service plan.

Overrides deep-merge into the request. Fields you set replace their counterparts, and everything you leave out is still sent. The full field list is in the Sinch SMS API docs.

Provider details

sinch

Courier recommends routing to the channel. Naming this key in routing.channels instead is supported, and sends through just this provider.

Send to a specific provider

When that is worth doing, and what you give up: failover, channel priority, and providers you add later.

Get started

Available integrations

Send SMS with Sinch through Courier

Prerequisites

Setup

Overrides

Provider details

Send to a specific provider

​Prerequisites

​Setup

​Overrides

​Provider details

Send to a specific provider

Prerequisites

Setup

Overrides

Provider details