SMS providers

Available providers

Twilio

Vonage

Telnyx

Sinch

Plivo

Bird

MessageMedia

Azure Communication Services

Amazon SNS

TextUs

Africa's Talking

SMSCentral

Amazon SNS also sends . is the only one here that carries MMS.

Profile requirements

Every SMS provider addresses the recipient the same way, by phone number, so the profile you send to needs a phone_number. Store it once with , which merges into the profile and creates it if it does not exist:

const profile = await client.profiles.create('user_123', {
  profile: {
    phone_number: '+15551234567',
  },
});

profile = client.profiles.create(
    user_id="user_123",
    profile={
        "phone_number": "+15551234567",
    },
)

curl --request POST \
  --url https://api.courier.com/profiles/user_123 \
  --header "Authorization: Bearer $COURIER_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "profile": {
      "phone_number": "+15551234567"
    }
  }'

profile = courier.profiles.create(
  "user_123",
  profile: {
    phone_number: "+15551234567"
  }
)

profile, err := client.Profiles.New(
	context.TODO(),
	"user_123",
	courier.ProfileNewParams{
		Profile: map[string]any{
			"phone_number": "+15551234567",
		},
	},
)

ProfileCreateParams params = ProfileCreateParams.builder()
    .userId("user_123")
    .profile(ProfileCreateParams.Profile.builder()
        .putAdditionalProperty("phone_number", JsonValue.from("+15551234567"))
        .build())
    .build();
ProfileCreateResponse profile = client.profiles().create(params);

$profile = $client->profiles->create('user_123', profile: [
  'phone_number' => '+15551234567',
]);

ProfileCreateParams parameters = new()
{
    UserID = "user_123",
    Profile = new Dictionary<string, JsonElement>()
    {
        { "phone_number", JsonSerializer.SerializeToElement("+15551234567") },
    },
};
var profile = await client.Profiles.Create(parameters);

courier profiles create \
  --api-key "$COURIER_API_KEY" \
  --user-id user_123 \
  --profile '{"phone_number":"+15551234567"}'

With Courier MCP, create a profile for user_123 with the phone number +15551234567.

Store the number in E.164 form, with the country code and a leading +. A provider that accepts a local format at its own API does not change what Courier stores, and a number without a country code fails at the provider rather than at the send.

Send to a recipient

Send to user id
Send to phone number

Courier reads phone_number off the saved profile, so preferences apply and the number can change without touching this code.

const { requestId } = await courier.send.message({
  message: {
    to: {
      user_id: "user_123",
    },
    template: "nt_01kx4h2jdafq8bk9aftxak4b40",
  },
});

response = client.send.message(
    message={
        "to": {
            "user_id": "user_123",
        },
        "template": "nt_01kx4h2jdafq8bk9aftxak4b40",
    },
)

curl -X POST https://api.courier.com/send \
  -H "Authorization: Bearer $COURIER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": {
      "to": {
        "user_id": "user_123"
      },
      "template": "nt_01kx4h2jdafq8bk9aftxak4b40"
    }
  }'

response = courier.send_.message(
  message: {
    to: {
      user_id: "user_123"
    },
    template: "nt_01kx4h2jdafq8bk9aftxak4b40"
  }
)

response, err := client.Send.Message(context.TODO(), courier.SendMessageParams{
	Message: courier.SendMessageParamsMessage{
		To: courier.SendMessageParamsMessageToUnion{
			OfUserRecipient: &shared.UserRecipientParam{
				UserID: courier.String("user_123"),
			},
		},
		Template: courier.String("nt_01kx4h2jdafq8bk9aftxak4b40"),
	},
})

SendMessageParams params = SendMessageParams.builder()
    .message(SendMessageParams.Message.builder()
        .to(UserRecipient.builder().userId("user_123").build())
        .template("nt_01kx4h2jdafq8bk9aftxak4b40")
        .build())
    .build();
SendMessageResponse response = client.send().message(params);

$response = $client->send->message(
  message: [
    'to' => [
      'user_id' => 'user_123',
    ],
    'template' => 'nt_01kx4h2jdafq8bk9aftxak4b40',
  ],
);

SendMessageParams parameters = new()
{
    Message = new()
    {
        To = new UserRecipient { UserID = "user_123" },
        Template = "nt_01kx4h2jdafq8bk9aftxak4b40",
    },
};

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

courier send message \
  --api-key "$COURIER_API_KEY" \
  --message.to '{"user_id": "user_123"}' \
  --message.template nt_01kx4h2jdafq8bk9aftxak4b40

With Courier MCP, send my template to user_123 by SMS.

A one-off to a number you are not storing. No profile is created, so no preference applies.

const { requestId } = await courier.send.message({
  message: {
    to: {
      phone_number: "+15551234567",
    },
    template: "nt_01kx4h2jdafq8bk9aftxak4b40",
  },
});

response = client.send.message(
    message={
        "to": {
            "phone_number": "+15551234567",
        },
        "template": "nt_01kx4h2jdafq8bk9aftxak4b40",
    },
)

curl -X POST https://api.courier.com/send \
  -H "Authorization: Bearer $COURIER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": {
      "to": {
        "phone_number": "+15551234567"
      },
      "template": "nt_01kx4h2jdafq8bk9aftxak4b40"
    }
  }'

response = courier.send_.message(
  message: {
    to: {
      phone_number: "+15551234567"
    },
    template: "nt_01kx4h2jdafq8bk9aftxak4b40"
  }
)

response, err := client.Send.Message(context.TODO(), courier.SendMessageParams{
	Message: courier.SendMessageParamsMessage{
		To: courier.SendMessageParamsMessageToUnion{
			OfUserRecipient: &shared.UserRecipientParam{
				PhoneNumber: courier.String("+15551234567"),
			},
		},
		Template: courier.String("nt_01kx4h2jdafq8bk9aftxak4b40"),
	},
})

SendMessageParams params = SendMessageParams.builder()
    .message(SendMessageParams.Message.builder()
        .to(UserRecipient.builder().phoneNumber("+15551234567").build())
        .template("nt_01kx4h2jdafq8bk9aftxak4b40")
        .build())
    .build();
SendMessageResponse response = client.send().message(params);

$response = $client->send->message(
  message: [
    'to' => [
      'phone_number' => '+15551234567',
    ],
    'template' => 'nt_01kx4h2jdafq8bk9aftxak4b40',
  ],
);

SendMessageParams parameters = new()
{
    Message = new()
    {
        To = new UserRecipient { PhoneNumber = "+15551234567" },
        Template = "nt_01kx4h2jdafq8bk9aftxak4b40",
    },
};

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

courier send message \
  --api-key "$COURIER_API_KEY" \
  --message.to '{"phone_number": "+15551234567"}' \
  --message.template nt_01kx4h2jdafq8bk9aftxak4b40

With Courier MCP, send my template to +15551234567 by SMS.

Channel overrides

covers the two levels and which one wins. Most SMS providers accept these two in a provider override.

Field	Sets
`body`	The message text, the recipient number, or other request body fields
`config`	Credentials or sender numbers, swapped for this one send

Each provider page documents its own schema.

Can’t find a provider? Start a chat or email support@courier.com

Get started

Available integrations

Available providers

Twilio

Vonage

Telnyx

Sinch

Plivo

Bird

MessageMedia

Azure Communication Services

Amazon SNS

TextUs

Africa's Talking

SMSCentral

Profile requirements

Send to a recipient

Channel overrides

​Available providers

Twilio

Vonage

Telnyx

Sinch

Plivo

Bird

MessageMedia

Azure Communication Services

Amazon SNS

TextUs

Africa's Talking

SMSCentral

​Profile requirements

​Send to a recipient

​Channel overrides

Available providers

Profile requirements

Send to a recipient

Channel overrides