# wasell API — endpoint index > Version 1.0.0. Base URL: https://api.wasell.io/v1 > For clean Markdown of any endpoint, append `.md` to its docs URL. > For the full endpoint index, see https://app.wasell.io/docs/md/index.md. > To connect an AI client (Claude Code, Cursor, …), use the MCP server at https://api.wasell.io/mcp. > > Reference: https://app.wasell.io/docs ## Authentication - `Token` header (required) - `Authorization` header (required) ## Endpoints ### Webhooks - [Get webhooks](https://app.wasell.io/docs/md/getWebhooks.md) — `GET /webhooks` - [Register webhook](https://app.wasell.io/docs/md/createWebhook.md) — `POST /webhooks` - [Get webhook logs](https://app.wasell.io/docs/md/getWebhookLogs.md) — `GET /webhooks/{webhookId}/logs` - [Enable webhook](https://app.wasell.io/docs/md/enableWebhook.md) — `POST /webhooks/{webhookId}/enable` - [Get webhook details](https://app.wasell.io/docs/md/getWebhook.md) — `GET /webhooks/{webhookId}` - [Update webhook](https://app.wasell.io/docs/md/updateWebhook.md) — `PATCH /webhooks/{webhookId}` - [Delete webhook](https://app.wasell.io/docs/md/deleteWebhook.md) — `DELETE /webhooks/{webhookId}` ### Templates - [Upload template header media](https://app.wasell.io/docs/md/uploadTemplateMedia.md) — `POST /waba/templates/media` - [List templates](https://app.wasell.io/docs/md/getTemplates.md) — `GET /waba/templates` - [Create or update a template](https://app.wasell.io/docs/md/createOrUpdateTemplate.md) — `POST /waba/templates` - [Delete templates](https://app.wasell.io/docs/md/deleteTemplates.md) — `DELETE /waba/templates` ### Templates Pricing - [Get messaging prices](https://app.wasell.io/docs/md/getWabaPrices.md) — `GET /waba/prices` - [Calculate messaging costs](https://app.wasell.io/docs/md/calculateWabaCosts.md) — `POST /waba/prices` ### Flows - [List WhatsApp Flows](https://app.wasell.io/docs/md/getFlows.md) — `GET /waba/flows` ### Verify - [Username exists](https://app.wasell.io/docs/md/verifyUsername.md) — `POST /verify/username` - [Number exists](https://app.wasell.io/docs/md/verifyNumber.md) — `POST /verify/number` - [Validate username](https://app.wasell.io/docs/md/validateUsername.md) — `POST /validate/username` - [Validate numbers (Validate alias)](https://app.wasell.io/docs/md/validateNumber.md) — `POST /validate/number` - [Number exists](https://app.wasell.io/docs/md/verifyNumber.md) — `POST /numbers/exists` ### Team Members - [Get users](https://app.wasell.io/docs/md/getTeamUsers.md) — `GET /team` - [Update user](https://app.wasell.io/docs/md/updateTeamUser.md) — `PATCH /team` - [Delete users](https://app.wasell.io/docs/md/deleteUsers.md) — `DELETE /team` - [Get users per number](https://app.wasell.io/docs/md/getDeviceTeamMembers.md) — `GET /devices/{deviceId}/team` - [Create user](https://app.wasell.io/docs/md/createDeviceUser.md) — `POST /devices/{deviceId}/team` - [Grant user access](https://app.wasell.io/docs/md/grantDeviceUserAccess.md) — `PATCH /devices/{deviceId}/team` - [Revoke user access](https://app.wasell.io/docs/md/revokeDeviceUserAccess.md) — `DELETE /devices/{deviceId}/team` ### Pipeline - [Get pipelines](https://app.wasell.io/docs/md/getPipelines.md) — `GET /pipelines` - [Create pipeline](https://app.wasell.io/docs/md/createPipeline.md) — `POST /pipelines` - [Get pipeline](https://app.wasell.io/docs/md/getPipeline.md) — `GET /pipelines/{pipelineId}` - [Update pipeline](https://app.wasell.io/docs/md/updatePipeline.md) — `PATCH /pipelines/{pipelineId}` - [Delete pipeline](https://app.wasell.io/docs/md/deletePipeline.md) — `DELETE /pipelines/{pipelineId}` ### Numbers - [Validate numbers](https://app.wasell.io/docs/md/validateNumbers.md) — `POST /numbers/validate` ### Messages - [Search messages](https://app.wasell.io/docs/md/searchMessages.md) — `GET /messages` - [Send message](https://app.wasell.io/docs/md/createMessage.md) — `POST /messages` - [Get message by ID](https://app.wasell.io/docs/md/getMessage.md) — `GET /messages/{messageId}` - [Update queued message](https://app.wasell.io/docs/md/updateMessage.md) — `PATCH /messages/{messageId}` - [Delete message](https://app.wasell.io/docs/md/deleteMessage.md) — `DELETE /messages/{messageId}` ### Keypass - [Revoke the keypass helper token](https://app.wasell.io/docs/md/disconnectKeypass.md) — `POST /keypass/disconnect` - [List keypass-connectable numbers](https://app.wasell.io/docs/md/listKeypassDevices.md) — `GET /keypass/devices` - [Import keypass session credentials](https://app.wasell.io/docs/md/importDeviceKeypass.md) — `POST /devices/{deviceId}/keypass` ### Files - [Search files](https://app.wasell.io/docs/md/searchFiles.md) — `GET /files` - [Upload file](https://app.wasell.io/docs/md/uploadFile.md) — `POST /files` - [Delete many files](https://app.wasell.io/docs/md/deleteFiles.md) — `DELETE /files` - [Preview image](https://app.wasell.io/docs/md/previewFile.md) — `GET /files/{fileId}/preview` - [Download file content](https://app.wasell.io/docs/md/downloadFile.md) — `GET /files/{fileId}/download` - [Get file information](https://app.wasell.io/docs/md/getFile.md) — `GET /files/{fileId}` - [Update file](https://app.wasell.io/docs/md/updateFile.md) — `PATCH /files/{fileId}` - [Delete file](https://app.wasell.io/docs/md/deleteFile.md) — `DELETE /files/{fileId}` ### Devices - [Get numbers](https://app.wasell.io/docs/md/getDevices.md) — `GET /devices` - [Create number](https://app.wasell.io/docs/md/createDevice.md) — `POST /devices` - [Automatic chats deletion](https://app.wasell.io/docs/md/deviceAutoremoveChats.md) — `POST /devices/{deviceId}/removechats` - [Read chat messages](https://app.wasell.io/docs/md/deviceReadChats.md) — `POST /devices/{deviceId}/readchats` - [Delete chats](https://app.wasell.io/docs/md/deleteChats.md) — `DELETE /devices/{deviceId}/chats` - [Get number by ID](https://app.wasell.io/docs/md/getDeviceById.md) — `GET /devices/{deviceId}` - [Update number](https://app.wasell.io/docs/md/updateDevice.md) — `PATCH /devices/{deviceId}` - [Delete number](https://app.wasell.io/docs/md/deleteDevice.md) — `DELETE /devices/{deviceId}` ### Deals - [List account tasks](https://app.wasell.io/docs/md/listDealTasks.md) — `GET /deals/tasks` - [Hydrate deals](https://app.wasell.io/docs/md/hydrateDeals.md) — `POST /deals/hydrate` - [Get deals](https://app.wasell.io/docs/md/getDeals.md) — `GET /deals` - [Create deal](https://app.wasell.io/docs/md/createDeal.md) — `POST /deals` - [Dismiss the AI suggestion](https://app.wasell.io/docs/md/dismissDealSuggestion.md) — `DELETE /deals/{dealId}/suggestion` - [Move deal to another stage](https://app.wasell.io/docs/md/moveDealStage.md) — `PATCH /deals/{dealId}/stage` - [Dismiss the AI risk alert](https://app.wasell.io/docs/md/dismissDealRisk.md) — `DELETE /deals/{dealId}/risk` - [Update deal note](https://app.wasell.io/docs/md/updateDealNote.md) — `PATCH /deals/{dealId}/notes/{noteId}` - [Delete deal note](https://app.wasell.io/docs/md/deleteDealNote.md) — `DELETE /deals/{dealId}/notes/{noteId}` - [List deal notes](https://app.wasell.io/docs/md/listDealNotes.md) — `GET /deals/{dealId}/notes` - [Create deal note](https://app.wasell.io/docs/md/createDealNote.md) — `POST /deals/{dealId}/notes` - [List deal history](https://app.wasell.io/docs/md/listDealEvents.md) — `GET /deals/{dealId}/events` - [Link deal to a conversation](https://app.wasell.io/docs/md/linkDealChat.md) — `PUT /deals/{dealId}/chat` - [Get deal](https://app.wasell.io/docs/md/getDeal.md) — `GET /deals/{dealId}` - [Update deal](https://app.wasell.io/docs/md/updateDeal.md) — `PATCH /deals/{dealId}` - [Archive deal](https://app.wasell.io/docs/md/archiveDeal.md) — `DELETE /deals/{dealId}` ### Campaigns - [Get campaigns](https://app.wasell.io/docs/md/getCampaigns.md) — `GET /campaigns` - [Create campaign](https://app.wasell.io/docs/md/createCampaign.md) — `POST /campaigns` - [Start/stop campaign](https://app.wasell.io/docs/md/updateCampaign.md) — `PUT /campaigns/{campaignId}/status` - [List campaign contacts](https://app.wasell.io/docs/md/getCampaignContacts.md) — `GET /campaigns/{campaignId}/contacts` - [Update campaign contacts](https://app.wasell.io/docs/md/updateCampaignContacts.md) — `PATCH /campaigns/{campaignId}/contacts` - [Delete campaign contacts](https://app.wasell.io/docs/md/deleteCampaignContacts.md) — `DELETE /campaigns/{campaignId}/contacts` - [Get campaign](https://app.wasell.io/docs/md/getCampaign.md) — `GET /campaigns/{campaignId}` - [Update campaign](https://app.wasell.io/docs/md/updateCampaign.md) — `PATCH /campaigns/{campaignId}` - [Delete campaign](https://app.wasell.io/docs/md/deleteCampaign.md) — `DELETE /campaigns/{campaignId}` ### Analytics - [Get analytics](https://app.wasell.io/docs/md/getAnalytics.md) — `GET /analytics` ### Funnel - [Get pipeline summary](https://app.wasell.io/docs/md/getPipelineSummary.md) — `GET /pipelines/{pipelineId}/summary` ### Chats - [Send typing status](https://app.wasell.io/docs/md/sendTypingStatus.md) — `POST /chat/{deviceId}/typing` - [Sync chats](https://app.wasell.io/docs/md/syncDeviceChats.md) — `POST /chat/{deviceId}/sync` - [Mark chat as read/unread](https://app.wasell.io/docs/md/updateChatReadStatus.md) — `PATCH /chat/{deviceId}/chats/{chatWid}/unread` - [Sync chat messages](https://app.wasell.io/docs/md/syncDeviceChatMessages.md) — `GET /chat/{deviceId}/chats/{chatWid}/sync` - [Update chat status](https://app.wasell.io/docs/md/setChatStatus.md) — `PATCH /chat/{deviceId}/chats/{chatWid}/status` - [Get group participants](https://app.wasell.io/docs/md/getGroupParticipants.md) — `GET /chat/{deviceId}/chats/{chatWid}/participants` - [Assign chat](https://app.wasell.io/docs/md/assignChatAgent.md) — `PATCH /chat/{deviceId}/chats/{chatWid}/owner` - [Unassign chat](https://app.wasell.io/docs/md/unassignChatAgent.md) — `DELETE /chat/{deviceId}/chats/{chatWid}/owner` - [Create note](https://app.wasell.io/docs/md/createChatNote.md) — `POST /chat/{deviceId}/chats/{chatWid}/notes` - [Delete note](https://app.wasell.io/docs/md/deleteChatNote.md) — `DELETE /chat/{deviceId}/chats/{chatWid}/notes` - [Update chat labels](https://app.wasell.io/docs/md/updateChatLabels.md) — `PATCH /chat/{deviceId}/chats/{chatWid}/labels` - [Update chat attributes](https://app.wasell.io/docs/md/updateChatMeta.md) — `PATCH /chat/{deviceId}/chats/{chatWid}/attributes` - [Archive chat](https://app.wasell.io/docs/md/archiveChat.md) — `PUT /chat/{deviceId}/chats/{chatWid}/archive` - [Unarchive chat](https://app.wasell.io/docs/md/unarchiveChat.md) — `DELETE /chat/{deviceId}/chats/{chatWid}/archive` - [Get chat by WID](https://app.wasell.io/docs/md/getDeviceChatDetails.md) — `GET /chat/{deviceId}/chats/{chatWid}` - [Delete chat](https://app.wasell.io/docs/md/deleteDeviceChat.md) — `DELETE /chat/{deviceId}/chats/{chatWid}` - [Search chats](https://app.wasell.io/docs/md/getDeviceChats.md) — `GET /chat/{deviceId}/chats` - [Bulk chats update](https://app.wasell.io/docs/md/bulkChatsUpdate.md) — `PATCH /chat/{deviceId}/chats` ### User Status - [Get status by ID](https://app.wasell.io/docs/md/getUserStatusById.md) — `GET /chat/{deviceId}/status/{statusId}` - [Search status](https://app.wasell.io/docs/md/getUserStatus.md) — `GET /chat/{deviceId}/status` - [Publish new status](https://app.wasell.io/docs/md/updateUserStatus.md) — `POST /chat/{deviceId}/status` - [Delete user status](https://app.wasell.io/docs/md/deleteUserStatus.md) — `DELETE /chat/{deviceId}/status` ### Chat Messages - [Get message delivery info](https://app.wasell.io/docs/md/getMessageAckInfo.md) — `GET /chat/{deviceId}/messages/{messageWid}/ackinfo` - [Get message details](https://app.wasell.io/docs/md/getDeviceMessageDetails.md) — `GET /chat/{deviceId}/messages/{messageWid}` - [Edit message](https://app.wasell.io/docs/md/editMessage.md) — `PATCH /chat/{deviceId}/messages/{messageWid}` - [Delete message](https://app.wasell.io/docs/md/deleteDeviceMessage.md) — `DELETE /chat/{deviceId}/messages/{messageWid}` - [Search messages](https://app.wasell.io/docs/md/getChatMessages.md) — `GET /chat/{deviceId}/messages` ### Chat Files - [Download file](https://app.wasell.io/docs/md/downloadDeviceFileDetails.md) — `GET /chat/{deviceId}/files/{fileId}/download` - [Get file details](https://app.wasell.io/docs/md/getDeviceFileDetails.md) — `GET /chat/{deviceId}/files/{fileId}` - [Files](https://app.wasell.io/docs/md/getDeviceFiles.md) — `GET /chat/{deviceId}/files` ### Chat Contacts - [Set metadata](https://app.wasell.io/docs/md/updateContactMetadata.md) — `PUT /chat/{deviceId}/contacts/{contactWid}/metadata` - [Update metadata](https://app.wasell.io/docs/md/upsertContactMetadata.md) — `PATCH /chat/{deviceId}/contacts/{contactWid}/metadata` - [Get contact](https://app.wasell.io/docs/md/getDeviceContactDetails.md) — `GET /chat/{deviceId}/contacts/{contactWid}` - [Update contact](https://app.wasell.io/docs/md/updateContact.md) — `PATCH /chat/{deviceId}/contacts/{contactWid}` - [Delete contact](https://app.wasell.io/docs/md/deleteContact.md) — `DELETE /chat/{deviceId}/contacts/{contactWid}` - [Contacts](https://app.wasell.io/docs/md/getDeviceContacts.md) — `GET /chat/{deviceId}/contacts` - [Create contact](https://app.wasell.io/docs/md/createContact.md) — `POST /chat/{deviceId}/contacts` - [Bulk create contacts](https://app.wasell.io/docs/md/bulkCreateContacts.md) — `PATCH /chat/{deviceId}/contacts` ### Session - [Sync session](https://app.wasell.io/docs/md/syncSession.md) — `GET /devices/{deviceId}/sync` - [Start session](https://app.wasell.io/docs/md/startDevice.md) — `POST /devices/{deviceId}/start` - [Scan QR image](https://app.wasell.io/docs/md/scanQR.md) — `GET /devices/{deviceId}/scan` - [Disconnect session](https://app.wasell.io/docs/md/resetDevice.md) — `POST /devices/{deviceId}/reset` - [Reboot session](https://app.wasell.io/docs/md/rebootDevice.md) — `POST /devices/{deviceId}/reboot` - [Accept Meta's AI terms](https://app.wasell.io/docs/md/acceptMetaAiTerms.md) — `POST /devices/{deviceId}/meta-ai-terms/accept` - [Session health](https://app.wasell.io/docs/md/deviceHealth.md) — `GET /devices/{deviceId}/health` - [Request pairing code](https://app.wasell.io/docs/md/requestNumberAuthCode.md) — `POST /devices/{deviceId}/authcode` ### Quick Replies - [List quick replies](https://app.wasell.io/docs/md/getQuickReplies.md) — `GET /devices/{deviceId}/quickReplies` - [Create quick reply](https://app.wasell.io/docs/md/createQuickReply.md) — `POST /devices/{deviceId}/quickReplies` - [Update quick reply](https://app.wasell.io/docs/md/updateQuickReply.md) — `PATCH /devices/{deviceId}/quickReplies` - [Delete quick replies](https://app.wasell.io/docs/md/deleteQuickReplies.md) — `DELETE /devices/{deviceId}/quickReplies` ### Queue - [Queue stats](https://app.wasell.io/docs/md/getQueueStatus.md) — `GET /devices/{deviceId}/queue` - [Update queue status](https://app.wasell.io/docs/md/setQueueStatus.md) — `POST /devices/{deviceId}/queue` - [Transfer queued messages](https://app.wasell.io/docs/md/routeQueue.md) — `PATCH /devices/{deviceId}/queue` - [Empty queue](https://app.wasell.io/docs/md/emptyQueue.md) — `DELETE /devices/{deviceId}/queue` ### Profile - [Profile image](https://app.wasell.io/docs/md/deviceProfileImage.md) — `GET /devices/{deviceId}/profile/image` - [Update profile image](https://app.wasell.io/docs/md/updateProfileImage.md) — `PUT /devices/{deviceId}/profile/image` - [Get profile](https://app.wasell.io/docs/md/deviceProfile.md) — `GET /devices/{deviceId}/profile` - [Update profile](https://app.wasell.io/docs/md/deviceProfileUpdate.md) — `PATCH /devices/{deviceId}/profile` ### Meeting Links - [Get meeting links](https://app.wasell.io/docs/md/getMeetingLinks.md) — `GET /devices/{deviceId}/meeting-links` - [Create meeting link](https://app.wasell.io/docs/md/createMeetingLink.md) — `POST /devices/{deviceId}/meeting-links` - [Delete meeting links](https://app.wasell.io/docs/md/deleteMeetingLinks.md) — `DELETE /devices/{deviceId}/meeting-links` ### Labels - [List labels](https://app.wasell.io/docs/md/getLabels.md) — `GET /devices/{deviceId}/labels` - [Create label](https://app.wasell.io/docs/md/createLabel.md) — `POST /devices/{deviceId}/labels` - [Update label](https://app.wasell.io/docs/md/updateLabel.md) — `PATCH /devices/{deviceId}/labels` - [Delete label](https://app.wasell.io/docs/md/deletelabel.md) — `DELETE /devices/{deviceId}/labels` ### Billing - [Invoice PDF](https://app.wasell.io/docs/md/getDeviceInvoicePDF.md) — `GET /devices/{deviceId}/invoices/{invoiceId}/pdf` - [List invoices](https://app.wasell.io/docs/md/getDeviceInvoices.md) — `GET /devices/{deviceId}/invoices` ### Groups - [Add participants](https://app.wasell.io/docs/md/addGroupParticipants.md) — `POST /devices/{deviceId}/groups/{groupId}/participants` - [Promote/demote participants](https://app.wasell.io/docs/md/updateParticipantsPermissions.md) — `PATCH /devices/{deviceId}/groups/{groupId}/participants` - [Remove participants](https://app.wasell.io/docs/md/removeGroupParticipants.md) — `DELETE /devices/{deviceId}/groups/{groupId}/participants` - [Get pending group members](https://app.wasell.io/docs/md/getGroupPendingMembers.md) — `GET /devices/{deviceId}/groups/{groupId}/members` - [Approve group member](https://app.wasell.io/docs/md/approveGroupMembers.md) — `POST /devices/{deviceId}/groups/{groupId}/members` - [Reject group member](https://app.wasell.io/docs/md/rejectGroupMembers.md) — `DELETE /devices/{deviceId}/groups/{groupId}/members` - [Get group invite code](https://app.wasell.io/docs/md/getGroupInviteCode.md) — `GET /devices/{deviceId}/groups/{groupId}/invite` - [Revoke group invite](https://app.wasell.io/docs/md/revokeGroupInvite.md) — `DELETE /devices/{deviceId}/groups/{groupId}/invite` - [Set group image](https://app.wasell.io/docs/md/groupUpdateImage.md) — `PUT /devices/{deviceId}/groups/{groupId}/image` - [Get group by ID](https://app.wasell.io/docs/md/getGroupById.md) — `GET /devices/{deviceId}/groups/{groupId}` - [Update group](https://app.wasell.io/docs/md/updateGroup.md) — `PATCH /devices/{deviceId}/groups/{groupId}` - [Group chats](https://app.wasell.io/docs/md/getDeviceGroupChats.md) — `GET /devices/{deviceId}/groups` - [Create group](https://app.wasell.io/docs/md/createGroup.md) — `POST /devices/{deviceId}/groups` - [Join group](https://app.wasell.io/docs/md/joinGroup.md) — `PUT /devices/{deviceId}/groups` - [Leave group](https://app.wasell.io/docs/md/leaveGroup.md) — `DELETE /devices/{deviceId}/groups` ### Departments - [Get departments](https://app.wasell.io/docs/md/getDepartments.md) — `GET /devices/{deviceId}/departments` - [Create department](https://app.wasell.io/docs/md/createDepartment.md) — `POST /devices/{deviceId}/departments` - [Update department](https://app.wasell.io/docs/md/updateDepartment.md) — `PATCH /devices/{deviceId}/departments` - [Delete department](https://app.wasell.io/docs/md/deleteDepartment.md) — `DELETE /devices/{deviceId}/departments` ### Channels - [Update channel image](https://app.wasell.io/docs/md/channelUpdateImage.md) — `PUT /devices/{deviceId}/channels/{channelId}/image` - [Get channel by ID](https://app.wasell.io/docs/md/getChannelById.md) — `GET /devices/{deviceId}/channels/{channelId}` - [Update channel](https://app.wasell.io/docs/md/updateChannel.md) — `PATCH /devices/{deviceId}/channels/{channelId}` - [Delete channel](https://app.wasell.io/docs/md/deleteChannel.md) — `DELETE /devices/{deviceId}/channels/{channelId}` - [Get channels](https://app.wasell.io/docs/md/getDeviceChannels.md) — `GET /devices/{deviceId}/channels` - [Create channel](https://app.wasell.io/docs/md/createChannel.md) — `POST /devices/{deviceId}/channels` - [Join channel](https://app.wasell.io/docs/md/joinChannel.md) — `PUT /devices/{deviceId}/channels` - [Search channels](https://app.wasell.io/docs/md/searchChannels.md) — `PATCH /devices/{deviceId}/channels` ### Business catalog - [Get catalog](https://app.wasell.io/docs/md/getCatalog.md) — `GET /devices/{deviceId}/catalog` - [Query catalog](https://app.wasell.io/docs/md/queryCatalog.md) — `POST /devices/{deviceId}/catalog` ### Contacts - [Block contacts](https://app.wasell.io/docs/md/blockContacts.md) — `POST /devices/{deviceId}/block` - [Unblock contacts](https://app.wasell.io/docs/md/unblockContacts.md) — `DELETE /devices/{deviceId}/block` ### Automatic Replies - [Get auto replies](https://app.wasell.io/docs/md/getAutoReplies.md) — `GET /devices/{deviceId}/autoreplies` - [Update auto replies](https://app.wasell.io/docs/md/updateAutoReplies.md) — `PATCH /devices/{deviceId}/autoreplies` ### Automatic Assignment - [Get chats auto-assignment](https://app.wasell.io/docs/md/getChatAutoAssignment.md) — `GET /devices/{deviceId}/autoassign` - [Update chats auto-assignment](https://app.wasell.io/docs/md/updateChatAutoAssignment.md) — `PATCH /devices/{deviceId}/autoassign`