Send SMS with MessageMedia through Courier

Prerequisites

A MessageMedia account
Access to API settings in the MessageMedia console

Setup

In the MessageMedia console:

Create a new API key

Create a new API key.

Copy the API key and secret

Save the api_secret now. MessageMedia will not show it again.

In Courier, open the page, paste your credentials, and 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, config, and headers Courier sends to MessageMedia. Override apiKey, apiSecret, isHmacEnabled, and url via config, and any SendMessages body field via body.

const { requestId } = await courier.send.message({
  message: {
    template: "nt_01kx4h2jdafq8bk9aftxak4b40",
    to: {
      phone_number: "+12345678901",
    },
    providers: {
      messagemedia: {
        override: {
          body: {
            source_number: "+15555555555",
          },
          config: {
            apiKey: "<override API key>",
            apiSecret: "<override API secret>",
          },
        },
      },
    },
  },
});

response = client.send.message(
    message={
        "template": "nt_01kx4h2jdafq8bk9aftxak4b40",
        "to": {
            "phone_number": "+12345678901",
        },
        "providers": {
            "messagemedia": {
                "override": {
                    "body": {
                        "source_number": "+15555555555",
                    },
                    "config": {
                        "apiKey": "<override API key>",
                        "apiSecret": "<override API secret>",
                    },
                },
            },
        },
    },
)

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": {
        "messagemedia": {
          "override": {
            "body": {
              "source_number": "+15555555555"
            },
            "config": {
              "apiKey": "<override API key>",
              "apiSecret": "<override API secret>"
            }
          }
        }
      }
    }
  }'

response = courier.send_.message(
  message: {
    template: "nt_01kx4h2jdafq8bk9aftxak4b40",
    to: {
      phone_number: "+12345678901"
    },
    providers: {
      messagemedia: {
        override: {
          body: {
            source_number: "+15555555555"
          },
          config: {
            apiKey: "<override API key>",
            apiSecret: "<override API secret>"
          }
        }
      }
    }
  }
)

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{
			"messagemedia": shared.MessageProvidersTypeParam{
				Override: map[string]any{
					"body": map[string]any{
						"source_number": "+15555555555",
					},
					"config": map[string]any{
						"apiKey": "<override API key>",
						"apiSecret": "<override API secret>",
					},
				},
			},
		},
	},
})

SendMessageParams params = SendMessageParams.builder()
    .message(SendMessageParams.Message.builder()
        .to(UserRecipient.builder().phoneNumber("+12345678901").build())
        .template("nt_01kx4h2jdafq8bk9aftxak4b40")
        .providers(MessageProviders.builder()
            .putAdditionalProperty("messagemedia", JsonValue.from(java.util.Map.of("override", java.util.Map.of(
                    "body", java.util.Map.of(
                        "source_number", "+15555555555"
                    ),
                    "config", java.util.Map.of(
                        "apiKey", "<override API key>",
                        "apiSecret", "<override API secret>"
                    )
                ))))
            .build())
        .build())
    .build();
SendMessageResponse response = client.send().message(params);

$response = $client->send->message(
  message: [
    'template' => 'nt_01kx4h2jdafq8bk9aftxak4b40',
    'to' => [
      'phone_number' => '+12345678901',
    ],
    'providers' => [
      'messagemedia' => [
        'override' => [
          'body' => [
            'source_number' => '+15555555555',
          ],
          'config' => [
            'apiKey' => '<override API key>',
            'apiSecret' => '<override API secret>',
          ],
        ],
      ],
    ],
  ],
);

SendMessageParams parameters = new()
{
    Message = new()
    {
        To = new UserRecipient { PhoneNumber = "+12345678901" },
        Template = "nt_01kx4h2jdafq8bk9aftxak4b40",
        Providers = new Dictionary<string, MessageProvidersType>()
        {
            {
                "messagemedia",
                new()
                {
                    Override = JsonSerializer.Deserialize<Dictionary<string, JsonElement>>(
                        """
                        {
                          "body": {
                            "source_number": "+15555555555"
                          },
                          "config": {
                            "apiKey": "<override API key>",
                            "apiSecret": "<override API secret>"
                          }
                        }
                        """
                    ),
                }
            },
        },
    },
};

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 '{"messagemedia": {"override": {"body": {"source_number": "+15555555555"}, "config": {"apiKey": "<override API key>", "apiSecret": "<override API secret>"}}}}'

With Courier MCP, send my template to +12345678901 through MessageMedia with a different API key.

Delivery tracking

Courier gives the integration a unique webhook URL. Point MessageMedia webhooks at it to sync delivery updates into Courier’s message logs. Copy the URL from the in Courier, then follow these steps in the MessageMedia console:

Create a new webhook

Select “New Webhook”.

Paste Courier's webhook URL

Paste the URL you copied.

Select the delivery report events

Under “Event”, select “Message is rejected”, “Message has failed”, and “Message is delivered” in Delivery reports.

Map the webhook content

Under “Content”, map the fields passed to Courier’s webhook endpoint.

Only messageId, receivedTimestamp, status, and statusCode are supported.

Delivery updates now appear in the message logs.

Provider details

messagemedia

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 MessageMedia through Courier

Prerequisites

Setup

Overrides

Delivery tracking

Provider details

Send to a specific provider

​Prerequisites

​Setup

​Overrides

​Delivery tracking

​Provider details

Send to a specific provider

Prerequisites

Setup

Overrides

Delivery tracking

Provider details