Zernio
APIFor you
Zernio
APIFor you
API Reference

Messages

Conversations

List conversationsGETSearch conversationsGETCreate conversationPOSTGet conversationGETUpdate conversation statusPUTMark a conversation as readPOSTChange who answers a conversation (handover)POST

Messages

List messagesGETSend messagePOSTEdit messagePATCHDelete messageDELETEUpload media filePOSTResolve message attachmentGET

Reactions & Typing

Add reactionPOSTRemove reactionDELETESend typing indicatorPOST

Other

Accept a message requestPOSTAdd a label to a conversationPOSTCreate a conversation labelPOSTDelete conversationDELETEDelete a conversation labelDELETEList the labels on a conversationGETList the Page's conversation labelsGETRemove a label from a conversationDELETE
Dashboard
OverviewPlatformsAPI ReferenceResources
Messages

Create a conversation label

Facebook Messenger only. Creates a custom label on the Page (Graph POST /{page-id}/custom_labels). Other platforms answer 400 platform_not_supported.


POST
/v1/inbox/labels

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.messages.createInboxLabel({  body: {    accountId: 'account_abc123',    name: 'Example',  },});console.log(data);
{  "label": {    "id": "string",    "name": "string"  }}
Was this page helpful?

Add a label to a conversation

Facebook Messenger only. Applies one of the Page's custom labels to the person in this conversation (Graph `POST /{label-id}/label?user={psid}`). The id must be one of the Page's custom labels, otherwise 404 `resource_not_found`. Other platforms answer 400 `platform_not_supported`.

Delete conversation

Permanently deletes Zernio's stored copy of one conversation and every message in it, in one transaction, and unlinks the contact channel that pointed at it. Nothing is deleted on the platform (the thread stays in WhatsApp, Messenger or Instagram), and the contact record is kept: call DELETE /v1/contacts/{contactId} to erase the person's name and number as well. A platform re-sync can import the thread again: WhatsApp coexistence numbers receive their messaging history from Meta repeatedly, and a Facebook or Instagram account whose DM history walk has not finished imports it on that walk. Inbound media copies Zernio stored are removed on a best-effort basis.

accountId*string

Facebook social account ID

name*string

Label name

Length1 <= length