Inbox API
WhatsApp Inbox API is an HTTP API for 1MSG Inbox. Your code does in Inbox what an operator does on the Platform: list conversations, assign them, open and close them, and block a contact. Your team keeps working in Inbox as usual and sees every change your code makes. Each action leaves a system message in the chat.
The two APIs split the work. The WhatsApp Business API sends and receives messages. Inbox API manages who handles a conversation, what state it is in, and what has changed. You still reply to customers through the WhatsApp Business API. Incoming messages and delivery statuses still arrive at your channel webhook. Inbox events go to their own webhook, and each one is signed.
API key
Sign in at platform.1msg.io. Open Settings → Developer → API Settings, generate a key, and copy it. The full key is shown once.
Send it on every request:
Authorization: Bearer 1msg_live_••••••••The key belongs to a user and has that user's permissions. When the key is issued, choose Inbox, Campaigns, or both. It sees the same channels, and every action is made on that user's behalf. For all channels, the account owner creates a key for themselves. To work within a teammate's permissions, create a key for that teammate.
Methods
- List inbox contacts for copy into a campaign segment GET
- List channels visible to this key GET
- People who can be assigned on this channel GET
- List conversations GET
- Search conversations GET
- Conversation counts GET
- One conversation GET
- Messages in a conversation GET
- Assign, reassign, or clear the conversation assignee PATCH
- Open or close a conversation PATCH
- Block the contact POST
- Unblock the contact POST
- Rename a conversation PATCH
- Read the account inbox webhook GET
- Remove the account inbox webhook DELETE
- Set the account inbox webhook URL PUT
- Rotate the inbox webhook signing secret POST