Partner API for SaaS platforms: connect your customers' channels
easyCoexistence's Partner API lets your software connect its customers' WhatsApp numbers and their Instagram, Facebook, TikTok, YouTube and LinkedIn accounts, and more channels, through a hosted connect link. Your backend then gets each connection's credentials, routes its messages and comments to your webhook and hears when one drops, all on each network's official API, at US$ 9 to US$ 0.75 per connection.
- A hosted connect link, Stripe Checkout style
- Credentials, webhooks and events per connection
- US$ 9 to US$ 0.75 per connection, 3 days free
Quick reference
- Base URL
- https://easycoexistence.com/api/v1
- Auth
- Authorization: Bearer ec_live_…, one key per account
- Connect
- POST /connect-sessions, with channel for a social account
- Numbers
- GET /connections, and /connections/:id
- Social accounts
- GET /channels, and /channels/:id
- Credentials
- ?credentials=1 on a connection or a channel
- Webhooks
- PUT /connections/:id/webhook or /channels/:id/webhook
- Events
- connection.* and channel.*, signed, retried for about 33 hours
Connect your customers in three steps
- 1Create an API keyIn the dashboard, Profile, then Developers, or ask your assistant to run create_api_key. One key per account, shown once.
- 2Send your customer to a connect linkYour backend creates a session; your customer signs in to the network from a hosted page and comes back to your redirect URL.
- 3Use the connectionFetch its credentials, point its webhook at your system and handle the signed events that say when it connects or drops.
Connect your first channel in two minutes.
No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.
- 3 days free
- Cancel any time
- Official APIs only
- Monitored 24/7
Guides for platforms
Each part of building on the Partner API, from the connect link to the events that say a connection dropped.
- How to let your users connect WhatsApp, Instagram and TikTok accounts to your appHosted connect links for your users' WhatsApp numbers and social accounts: the session request, the redirect and its parameters, status, expiry and retries.
- WhatsApp Embedded Signup for your customers: your own Tech Provider app or a hosted pageHow a SaaS connects its customers' WhatsApp numbers with Coexistence: what Meta asks of a Tech Provider, what a hosted page takes on, and what customers see.
- Partner API authentication: Bearer ec_live_ keys, rotation and 401 errorsHow Partner API requests authenticate: one ec_live_ key per account, made in the dashboard or with create_api_key, shown once, rotated at once, and the 401.
- Unified API pricing for SaaS platforms: US$ 9 to US$ 0.75 per connectionHow a platform pays for its customers' channels: US$ 9 to US$ 0.75 per connection, worked out for 10, 100 and 1,000 customers, with Meta's charges kept apart.
- Partner API limits and rules: Meta's policies, 20 messages per second and the 14-day ruleRules a platform keeps for its customers' channels: Meta's WhatsApp policies, 20 messages per second per Coexistence number, the 14-day rule, what ends a key.
- How to get your customers' API tokens for WhatsApp, Instagram and TikTokWhat the credentials call returns for a customer's WhatsApp number and each social account, field by field, and how token rotation and token_ready work.
- How to receive your customers' WhatsApp messages and social comments by webhookA webhook per connection: WhatsApp messages straight from Meta, authenticated by a secret in the URL, and social comments and DMs signed with X-EC-Signature.
- How to know when a customer's WhatsApp or social connection dropsThe connection.* and channel.* status events: payloads, reasons such as PRIMARY_INACTIVITY, X-EC-Signature, retries over about 33 hours and dedupe on id.
- How to import WhatsApp Business app chat history and contacts through the APIImport a WhatsApp Business app number's contacts and up to 180 days of chats through Coexistence: history webhooks, chunk_order, progress and 2593109.
- How to build an AI agent product on your customers' WhatsApp, Instagram and TikTokBuild an AI agent product on your customers' WhatsApp, Instagram, Facebook and TikTok with the Partner API, your own model and the rules each network sets.
- White-label social media API: add posting, comments and DMs to your SaaS under your brandAdd posting, comment replies and DMs to your SaaS: what customers see, where easyCoexistence's name still shows, and the calls behind it.
- Unified social media API for SaaS: one integration for WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn and more channelsOne integration for your customers' WhatsApp, Instagram, Facebook, TikTok, YouTube and LinkedIn: what is unified, what each network decides, and the calls.
- How to let your customers connect Instagram to your appA hosted link for your customers' Instagram accounts: the session call, the token you get, and how your app posts and replies to comments and DMs.
- How to add TikTok posting to your SaaSAdd TikTok posting to your SaaS: connect each customer's TikTok, post videos or photo posts now or later with one call, and track each post to published.
- How to add WhatsApp to your SaaS with Embedded Signup and CoexistenceAdd WhatsApp to your SaaS: connect customers' numbers with Embedded Signup and Coexistence, receive messages, reply in the 24-hour window, send templates.
- Multi-tenant social media API: one API key, many customers' accountsOne API key for many customers' social and WhatsApp accounts: tag each with external_ref, keep tokens apart, route webhooks and events per customer.
- Build vs buy social media integrations: Meta, TikTok, YouTube and LinkedIn APIs for your SaaSWhat building Meta, TikTok, YouTube and LinkedIn integrations yourself takes: access reviews, token upkeep, webhooks and monitoring, against a partner API.
- How to build a social media scheduler on an API: the queue, media and post statusesBuild a social media scheduler on easyCoexistence's posts API: publish_at up to 90 days ahead, media copied when scheduled, six statuses and post events.
- AI agent SaaS architecture: reaching your customers' customers on WhatsApp, Instagram and TikTokThe architecture of an AI agent SaaS that replies to your customers' customers: connections, ingestion, a conversation store, the agent worker and outbound.
- Social media API for agencies: run your clients' accounts from your own softwareAn API for agencies: connect each client's accounts by hosted link, tag them with the client's id, publish with approval, route replies and build reports.
- Reselling social media features in your SaaS: margins on US$ 9 to US$ 0.75 per connectionWhat a SaaS earns reselling social media and WhatsApp features at US$ 9 to US$ 0.75 per connection: worked margins on a flat add-on and per account.
- Switching your SaaS from Ayrshare, Zernio or Unipile to easyCoexistence: what changes in your codeMoving a SaaS from Ayrshare, Zernio or Unipile to easyCoexistence: connect sessions, channel ids, posts per account, signed events and the cutover plan.
The full reference
Every endpoint, field and event, with the request and response bodies: Partner API reference.
Frequently asked questions
Do my customers need an easyCoexistence account?
No. They open a hosted page, sign in to the network and come back to your app, with no account, email or card. Every connection made through your key belongs to your account.
Who pays for my customers' connections?
Your account, per connection and the same on every network: US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free. On WhatsApp, Meta bills its own charges to the customer's WhatsApp Business Account.
Do messages pass through easyCoexistence?
Not on WhatsApp: Meta delivers a number's messages straight to the webhook you set. Comments and DMs from the social networks are forwarded to your endpoint as they arrive, signed per account, with no copy kept.
Can the connect page carry my brand?
The hosted page carries your name, for a number or a social account. The network's own sign-in, such as Meta's popup, names easyCoexistence as the app asking for access, and that cannot be renamed.