# Messaly Developers - [Messaly API](https://docs.telaven.com/index.md): Send SMS, WhatsApp and email, and keep your contacts and deals in step, from your own systems. - [Quickstart](https://docs.telaven.com/get-started/quickstart.md): Send your first SMS in about five minutes. You need an API key and one HTTP request, and no SDK. - [Authentication](https://docs.telaven.com/get-started/authentication.md): Every request carries an API key. Keys belong to your business and can be limited to certain actions, IP addresses and dates. - [Requests and responses](https://docs.telaven.com/get-started/requests-and-responses.md): Base URL, request format, pagination, phone numbers and money. - [Errors](https://docs.telaven.com/get-started/errors.md): Success is any 2xx. Errors use the HTTP status, a readable message and, where your code should branch, a stable code. - [Rate limits](https://docs.telaven.com/get-started/rate-limits.md): Each API key has its own request limit, counted over a sliding window. - [SMS](https://docs.telaven.com/guides/sms.md): Send transactional and bulk SMS on Safaricom, Airtel and Telkom, and track every delivery. - [SMS campaigns](https://docs.telaven.com/guides/sms-campaigns.md): Send one message to whole contact lists and tags, personalised for each person, now or later. - [WhatsApp](https://docs.telaven.com/guides/whatsapp.md): Send approved WhatsApp templates (order updates, reminders, codes, offers) and get replies and read receipts on your webhook. - [Email](https://docs.telaven.com/guides/email.md): Create and send email campaigns to your contact lists. Unsubscribes are handled for you. - [Contacts](https://docs.telaven.com/guides/contacts.md): Keep your customer list in step with your own systems, so your campaigns always reach the right people. - [CRM](https://docs.telaven.com/guides/crm.md): Push deals and companies from your own systems into the Messaly CRM, next to the campaigns you send them. - [Wallet and pricing](https://docs.telaven.com/guides/wallet.md): Check your balance and how your SMS price is worked out before a big send. - [Webhooks](https://docs.telaven.com/guides/webhooks.md): Instead of polling, let Messaly call your server when a message is delivered, a customer replies, someone opts out, a campaign finishes or a top-up lands. - [Get balance](https://docs.telaven.com/api-reference/account/get-balance.md): Your wallet balance in KES and how many SMS it covers at your current price. - [Get wallet and pricing](https://docs.telaven.com/api-reference/account/get-wallet-and-pricing.md): Balance in cents plus how your SMS price is worked out: your own price, a volume tier, or the standard price. - [Send SMS](https://docs.telaven.com/api-reference/sms/send-sms.md): Send one message to up to 1,000 numbers straight away. Charged per accepted message at your current price. - [List messages](https://docs.telaven.com/api-reference/sms/list-messages.md): Every SMS you've sent, newest first, from the API and from campaigns. - [Get message](https://docs.telaven.com/api-reference/sms/get-message.md): One message and its delivery status. - [SMS analytics](https://docs.telaven.com/api-reference/sms/sms-analytics.md): Totals and per-campaign results for a period. - [Daily SMS analytics](https://docs.telaven.com/api-reference/sms/daily-sms-analytics.md): Sent, delivered and failed counts per day. - [List campaigns](https://docs.telaven.com/api-reference/sms-campaigns/list-campaigns.md): Your SMS campaigns with totals and cost. - [Create campaign](https://docs.telaven.com/api-reference/sms-campaigns/create-campaign.md): Create a campaign from contact lists, contact tags and/or numbers. It's saved as a draft (or scheduled); send it with Send campaign. - [Get campaign](https://docs.telaven.com/api-reference/sms-campaigns/get-campaign.md): One campaign and its progress. - [Delete campaign](https://docs.telaven.com/api-reference/sms-campaigns/delete-campaign.md): Delete a campaign and its recipient list. - [Update campaign](https://docs.telaven.com/api-reference/sms-campaigns/update-campaign.md): Edit a draft campaign. Takes the same fields as Create campaign; recipients are rebuilt. - [Send campaign](https://docs.telaven.com/api-reference/sms-campaigns/send-campaign.md): Start sending a draft or scheduled campaign now, or pass scheduledAt to schedule it instead. Sending happens in the background. - [Schedule campaign](https://docs.telaven.com/api-reference/sms-campaigns/schedule-campaign.md): Set or change when a draft or scheduled campaign goes out (times are stored in Nairobi time). - [Campaign recipients](https://docs.telaven.com/api-reference/sms-campaigns/campaign-recipients.md): Each person in a campaign and what happened to their message. - [List contacts](https://docs.telaven.com/api-reference/contacts/list-contacts.md): Your contacts, newest first. - [Create contact](https://docs.telaven.com/api-reference/contacts/create-contact.md): Add one contact, optionally to a list and with tags. - [Get contact](https://docs.telaven.com/api-reference/contacts/get-contact.md): One contact. - [Delete contact](https://docs.telaven.com/api-reference/contacts/delete-contact.md): Remove a contact. - [List contact lists](https://docs.telaven.com/api-reference/contacts/list-contact-lists.md): Your contact lists with contact counts. - [Create contact list](https://docs.telaven.com/api-reference/contacts/create-contact-list.md): Create an empty list; add contacts with Create contact (listId). - [Get contact list](https://docs.telaven.com/api-reference/contacts/get-contact-list.md): One list with a breakdown of its contacts. - [Delete contact list](https://docs.telaven.com/api-reference/contacts/delete-contact-list.md): Delete a list and the contacts in it. - [Update contact list](https://docs.telaven.com/api-reference/contacts/update-contact-list.md): Rename a list or change its description. - [Get sending number](https://docs.telaven.com/api-reference/whatsapp/get-sending-number.md): The WhatsApp number your messages go out from (your own, or the shared Messaly number) and your price per message for each template category. - [Send WhatsApp template](https://docs.telaven.com/api-reference/whatsapp/send-whatsapp-template.md): Send one approved template to one person, filling in its variables, media header and button links. Charged from your wallet at the template category's price. - [List WhatsApp templates](https://docs.telaven.com/api-reference/whatsapp/list-whatsapp-templates.md): Your templates on the number you send from, with their review status and the variables each one needs. - [Create WhatsApp template](https://docs.telaven.com/api-reference/whatsapp/create-whatsapp-template.md): Submit a new template for review. Approval usually takes minutes; you'll see the status change in List WhatsApp templates. - [Get WhatsApp template](https://docs.telaven.com/api-reference/whatsapp/get-whatsapp-template.md): One template with the variables it needs. - [Delete WhatsApp template](https://docs.telaven.com/api-reference/whatsapp/delete-whatsapp-template.md): Delete a template here and in Meta. - [List WhatsApp campaigns](https://docs.telaven.com/api-reference/whatsapp/list-whatsapp-campaigns.md): Your 100 most recent WhatsApp campaigns with their progress. - [Create WhatsApp campaign](https://docs.telaven.com/api-reference/whatsapp/create-whatsapp-campaign.md): Send an approved template to many people, personalised for each one, now or at a set time. Opted-out numbers are skipped; each message is charged as it's sent. - [Estimate WhatsApp campaign](https://docs.telaven.com/api-reference/whatsapp/estimate-whatsapp-campaign.md): How many people a campaign would reach, what it costs, and whether your wallet covers it. Sends nothing. - [Get WhatsApp campaign](https://docs.telaven.com/api-reference/whatsapp/get-whatsapp-campaign.md): A campaign with counts by status, what it has cost so far, and the latest failures. - [Resume or cancel WhatsApp campaign](https://docs.telaven.com/api-reference/whatsapp/resume-or-cancel-whatsapp-campaign.md): Resume a stopped campaign after a top-up, or cancel a scheduled or stopped one. - [List email campaigns](https://docs.telaven.com/api-reference/email/list-email-campaigns.md): Your email campaigns. - [Create email campaign](https://docs.telaven.com/api-reference/email/create-email-campaign.md): Create an email campaign as a draft (or scheduled). - [Get email campaign](https://docs.telaven.com/api-reference/email/get-email-campaign.md): One email campaign. - [Delete email campaign](https://docs.telaven.com/api-reference/email/delete-email-campaign.md): Delete an email campaign. - [Update email campaign](https://docs.telaven.com/api-reference/email/update-email-campaign.md): Edit a draft email campaign (same fields as create). - [Send email campaign](https://docs.telaven.com/api-reference/email/send-email-campaign.md): Send a draft email campaign now. Unsubscribed addresses are skipped. - [List unsubscribes](https://docs.telaven.com/api-reference/email/list-unsubscribes.md): Addresses that opted out of your marketing email. - [Add unsubscribe](https://docs.telaven.com/api-reference/email/add-unsubscribe.md): Stop sending marketing email to an address. - [Re-subscribe an address](https://docs.telaven.com/api-reference/email/re-subscribe-an-address.md): Allow marketing email to an address again. - [List deals](https://docs.telaven.com/api-reference/crm/list-deals.md): Deals with pipeline totals. - [Create deal](https://docs.telaven.com/api-reference/crm/create-deal.md): Add a deal to a pipeline. - [List companies](https://docs.telaven.com/api-reference/crm/list-companies.md): Companies in your CRM. - [Create company](https://docs.telaven.com/api-reference/crm/create-company.md): Add a company. - [List pipelines](https://docs.telaven.com/api-reference/crm/list-pipelines.md): Deal pipelines and their stages. - [Create pipeline](https://docs.telaven.com/api-reference/crm/create-pipeline.md): Add a pipeline with its stages. ## OpenAPI Specs - [openapi](/openapi.json) ## Optional - [Dashboard](https://app.telaven.com) - [Website](https://telaven.com) - [Contact us](https://telaven.com/contact) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.