Skip to main content
Welcome to the momoGood Messaging API v2 (formerly the Tatango v2 API) — the platform management API for momoGood Messaging. Use it to manage lists, subscribers, custom fields, tags, webhooks, shortcodes, MOMT reports, and scheduled broadcasts from a single REST surface. It’s designed for developers, engineers, or anyone else who’s comfortable creating custom-coded solutions or integrating with RESTful APIs. If you’re not familiar with API concepts like HTTP response codes, REST endpoints, and JSON, try Zapier.
Looking for high-throughput omnichannel sending across SMS, MMS, RCS, and WhatsApp? See the momoGood Messaging API v3 — purpose-built for performance-sensitive delivery workloads.

Authentication

The momoGood Messaging API v2 authenticates requests by validating an API key that must be passed with each API call. We use the built-in HTTP basic authentication scheme supported by most HTTP libraries. Use your login email as the username and the API key as the password.
Make sure to replace my_api_key with your API key, which can be obtained by logging into the momoGood Messaging app.
You can access your API key here.

Returning multiple results and pagination

By default, GET API calls that return multiple items in a list will return up to 10 items for a single call. The pages_count parameter in the returned JSON will indicate the number of “pages” included in the entire result set. (So for example, if a call to https://app.tatango.com/api/v2/lists finds 27 lists in the system, the JSON will include the following (see JSON snippet below):
The pages_count parameter will default to 0 when there is no items in the list.
To fetch the next page of results, pass the page parameter on the URL, like this: https://app.tatango.com/api/v2/lists?page=2. You can also change the number of records returned in each “page” by passing in a “per_page” parameter as part of the URL, like this: https://app.tatango.com/api/v2/lists?per_page=50.
Note that the system will only allow up to 1000 records to be returned in a single call.

Carrier IDs

This section provides a list of carrier ID and names (US and Canada) for any response that includes carrier and carrierName.

United States Carriers

Canadian Carriers

Errors

The momoGood Messaging API v2 uses the following error codes: