Connecting an MTN Channel

The MTN Developer Portal gives you API access to SMS on MTN's networks in countries across Africa. Connect a number or short code you have with MTN to send and receive SMS with your contacts.

Before you start

You'll need an account on the MTN Developer Portal, and an app there with SMS added to it. MTN's guide to getting started explains how to register, create an app and add products to it. Once MTN approves your app, its consumer key and consumer secret are on your profile page.

Some of MTN's APIs need a formal agreement with MTN, so check with MTN what you need for your number or short code.

Adding the channel

Go to Settings > Channels and click New Channel. MTN is under SMS & Voice, or you can type its name in the search box. If your workspace's timezone isn't Africa/Brazzaville, check Show other regions to find it.

Then fill in the form:

Field What to enter
Number Your number or short code
Country The country your number is in
Consumer Key Your app's consumer key
Consumer Secret Your app's consumer secret
CP Address Only if MTN gave you one

Click Add Channel.

When you add the channel, it subscribes to your number's messages with MTN, so there's nothing more to set up on MTN's side. If MTN doesn't accept your consumer key and secret, you'll see an error and the channel isn't added.

Considerations

Messages are sent as plain text, and any attachments are sent as links.

To learn more about channels in general, see Introduction to Channels.

Last updated 12 November 2026