Accounts

Get active all accounts

In InboxComponents, an Account represents a specific communication channel or service that a client integrates into their environment. Currently, we support integration with WhatsApp accounts, with plans to include LinkedIn, Telegram, Instagram, and email (Gmail, Outlook) in the near future.​

🔑 Dashboard owners: Adding accounts via the dashboard

Dashboard owners can seamlessly add and manage accounts through the InboxComponents Dashboard.​

Steps to Add an Account:

1. Navigate to the Dashboard: Log in to your InboxComponents dashboard.​

2. Access the Accounts Section: Click on the Accounts tab in the main menu.​

3. Add a New Account: Select Add Account and choose the desired communication platform (e.g., WhatsApp).​

4. Configure Account Details: Enter the necessary information, such as account name and authentication credentials.​

5. Save and Authenticate: Click Save to authenticate and establish the connection.​

By following these steps, dashboard owners can centrally manage communication accounts, ensuring streamlined operations and oversight.​

You can manage your accounts here: https://app.inboxcomponents.com/portal/account

🔒 Customers: Adding accounts via the embedded inbox

Customers can integrate their own communication accounts directly within the embedded inbox of the host application. This approach enhances security by allowing customers to manage their credentials without exposing them to external parties.​

Benefits of Customer-Managed Integration:

• Enhanced Security: Customers retain control over their authentication credentials, reducing the risk of data exposure.​

• Personalized Experience: Enables customization of communication channels to align with individual preferences.​

• Operational Efficiency: Streamlines the integration process by allowing direct account management within the application.​

Steps for Customers to Add an Account:

1. Access the Embedded Inbox: Log in to the host application and navigate to the embedded inbox feature.​

2. Initiate Account Integration: Select the option to add a new account and choose the desired platform (e.g., WhatsApp).​

3. Authenticate the Account: Follow the on-screen instructions to enter authentication details and grant necessary permissions.​

4. Confirm Integration: Upon successful authentication, the account will be linked and ready for use within the embedded inbox.​

This method empowers customers to securely connect their communication channels, fostering trust and autonomy in managing their interactions.​

Future integrations

We are actively working to expand our supported integrations to include:​

• LinkedIn: Facilitating professional networking and communication.​

• Telegram: Enabling messaging through the popular Telegram platform.​

• InstaGram: Allowing interactions via Instagram's messaging features.​

• Email: Integrating traditional email communication channels.​

API Documentation

List connected accounts

get

Returns all connected accounts across all integrations. These accounts are used by the inbox to fetch and send messages.

Authorizations

BearerAuthApiKeyAuth

AuthorizationstringRequired

JWT token authentication (login via /authentication/login_check)

Query parameters

pageintegerOptional

The collection page number

Default: 1

Responses

200

Account collection

application/ld+jsonapplication/json

totalItemsintegerOptional

403

Forbidden

application/ld+jsonapplication/problem+jsonapplication/json

get

/api/accounts

HTTPcURLJavaScriptPython

GET /api/accounts HTTP/1.1
Host: app.inboxcomponents.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "member": [
    {
      "@context": "text",
      "@id": "text",
      "@type": "text",
      "username": "Michael Scott",
      "description": "Regional Manager at Dunder Mifflin",
      "avatarUrl": "https://example.com/avatars/michael_scott.png",
      "accountType": "whatsapp",
      "integrationLogo": "whatsapp",
      "integration": "\"/api/integrations/whatsapp",
      "isAuthorized": true,
      "sharePastHistory": true,
      "reconnectUrl": null,
      "createdAt": "2026-03-21T12:09:48.744Z",
      "disconnectedAt": null,
      "historySyncUntil": null,
      "clientId": "e6a2e786-2ce0-444a-b08c-ca21ed816bf0",
      "id": "e6a2e786-2ce0-444a-b08c-ca21ed816bf0"
    }
  ],
  "totalItems": 1,
  "view": {
    "@id": "string",
    "type": "string",
    "first": "string",
    "last": "string",
    "previous": "string",
    "next": "string"
  },
  "search": {
    "@type": "text",
    "template": "text",
    "variableRepresentation": "text",
    "mapping": [
      {
        "@type": "text",
        "variable": "text",
        "property": null,
        "required": true
      }
    ]
  }
}

Get connected account

get

Returns details of a specific connected account (e.g., WhatsApp number or LinkedIn login).

Authorizations

BearerAuthApiKeyAuth

AuthorizationstringRequired

JWT token authentication (login via /authentication/login_check)

Path parameters

idstringRequired

Account identifier

Responses

200

Account resource

application/ld+jsonapplication/json

Represents a connected account for an integration, such as a specific WhatsApp number, LinkedIn profile, or Instagram account. These are used by the inbox to send and receive messages.

@contextone ofRead-onlyOptional

stringOptional

or

@idstringRead-onlyOptional

@typestringRead-onlyOptional

usernamestring · nullableOptionalExample: Michael Scott

descriptionstring · nullableOptionalExample: Regional Manager at Dunder Mifflin

avatarUrlstring · nullableOptionalExample: https://example.com/avatars/michael_scott.png

accountTypestring · nullableOptionalExample: whatsapp

integrationLogostring · nullableOptionalExample: whatsapp

integrationstring · iri-referenceOptionalExample: "/api/integrations/whatsapp

isAuthorizedbooleanOptional

sharePastHistorybooleanOptional

reconnectUrlstring · nullableOptional

createdAtstring · date-timeOptional

disconnectedAtstring · nullableOptional

historySyncUntilstring · nullableOptional

clientIdstring · nullableOptionalExample: e6a2e786-2ce0-444a-b08c-ca21ed816bf0

idstring · nullableOptionalExample: e6a2e786-2ce0-444a-b08c-ca21ed816bf0

403

Forbidden

application/ld+jsonapplication/problem+jsonapplication/json

404

Not found

application/ld+jsonapplication/problem+jsonapplication/json

get

/api/accounts/{id}

HTTPcURLJavaScriptPython

GET /api/accounts/{id} HTTP/1.1
Host: app.inboxcomponents.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "username": "Michael Scott",
  "description": "Regional Manager at Dunder Mifflin",
  "avatarUrl": "https://example.com/avatars/michael_scott.png",
  "accountType": "whatsapp",
  "integrationLogo": "whatsapp",
  "integration": "\"/api/integrations/whatsapp",
  "isAuthorized": true,
  "sharePastHistory": true,
  "reconnectUrl": null,
  "createdAt": "2026-03-21T12:09:48.744Z",
  "disconnectedAt": null,
  "historySyncUntil": null,
  "clientId": "e6a2e786-2ce0-444a-b08c-ca21ed816bf0",
  "id": "e6a2e786-2ce0-444a-b08c-ca21ed816bf0"
}

Connect new account

post

Connects a new account (e.g., WhatsApp, LinkedIn, etc.) to the inbox. The payload includes authentication and setup details.

Authorizations

BearerAuthApiKeyAuth

AuthorizationstringRequired

JWT token authentication (login via /authentication/login_check)

Body

application/ld+jsonapplication/json

Represents a connected account for an integration, such as a specific WhatsApp number, LinkedIn profile, or Instagram account. These are used by the inbox to send and receive messages.

integrationstring · nullableRequiredExample: /integrations/{id}

historySyncUntilstring · nullableOptional

Responses

201

Account resource created

application/ld+jsonapplication/json

400

Invalid input

application/ld+jsonapplication/problem+jsonapplication/json

403

Forbidden

application/ld+jsonapplication/problem+jsonapplication/json

422

An error occurred

application/ld+jsonapplication/problem+jsonapplication/json

post

/api/accounts

HTTPcURLJavaScriptPython

POST /api/accounts HTTP/1.1
Host: app.inboxcomponents.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/ld+json
Accept: */*
Content-Length: 60

{
  "integration": "/integrations/{id}",
  "historySyncUntil": null
}

application/ld+jsonapplication/json

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "username": "Michael Scott",
  "description": "Regional Manager at Dunder Mifflin",
  "avatarUrl": "https://example.com/avatars/michael_scott.png",
  "accountType": "whatsapp",
  "integrationLogo": "whatsapp",
  "integration": "\"/api/integrations/whatsapp",
  "isAuthorized": true,
  "sharePastHistory": true,
  "reconnectUrl": null,
  "createdAt": "2026-03-21T12:09:48.744Z",
  "disconnectedAt": null,
  "historySyncUntil": null,
  "clientId": "e6a2e786-2ce0-444a-b08c-ca21ed816bf0",
  "id": "e6a2e786-2ce0-444a-b08c-ca21ed816bf0"
}

Disconnect account

delete

Removes a connected account from the inbox system.

Authorizations

BearerAuthApiKeyAuth

AuthorizationstringRequired

JWT token authentication (login via /authentication/login_check)

Path parameters

idstringRequired

Account identifier

Responses

204

Account resource deleted

403

Forbidden

application/ld+jsonapplication/problem+jsonapplication/json

404

Not found

application/ld+jsonapplication/problem+jsonapplication/json

delete

/api/accounts/{id}

HTTPcURLJavaScriptPython

DELETE /api/accounts/{id} HTTP/1.1
Host: app.inboxcomponents.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Update connected account

put

Updates configuration details for a connected account, such as access settings or metadata.

Authorizations

BearerAuthApiKeyAuth

AuthorizationstringRequired

JWT token authentication (login via /authentication/login_check)

Path parameters

idstringRequired

Account identifier

Body

application/ld+jsonapplication/json

Represents a connected account for an integration, such as a specific WhatsApp number, LinkedIn profile, or Instagram account. These are used by the inbox to send and receive messages.

@contextone ofRead-onlyOptional

stringOptional

or

@idstringRead-onlyOptional

@typestringRead-onlyOptional

usernamestring · nullableOptionalExample: Michael Scott

descriptionstring · nullableOptionalExample: Regional Manager at Dunder Mifflin

avatarUrlstring · nullableOptionalExample: https://example.com/avatars/michael_scott.png

accountTypestring · nullableOptionalExample: whatsapp

integrationLogostring · nullableOptionalExample: whatsapp

integrationstring · iri-referenceOptionalExample: "/api/integrations/whatsapp

isAuthorizedbooleanOptional

sharePastHistorybooleanOptional

reconnectUrlstring · nullableOptional

createdAtstring · date-timeOptional

disconnectedAtstring · nullableOptional

historySyncUntilstring · nullableOptional

clientIdstring · nullableOptionalExample: e6a2e786-2ce0-444a-b08c-ca21ed816bf0

idstring · nullableOptionalExample: e6a2e786-2ce0-444a-b08c-ca21ed816bf0

Responses

200

Account resource updated

application/ld+jsonapplication/json

Represents a connected account for an integration, such as a specific WhatsApp number, LinkedIn profile, or Instagram account. These are used by the inbox to send and receive messages.

@contextone ofRead-onlyOptional

stringOptional

or

@idstringRead-onlyOptional

@typestringRead-onlyOptional

usernamestring · nullableOptionalExample: Michael Scott

descriptionstring · nullableOptionalExample: Regional Manager at Dunder Mifflin

avatarUrlstring · nullableOptionalExample: https://example.com/avatars/michael_scott.png

accountTypestring · nullableOptionalExample: whatsapp

integrationLogostring · nullableOptionalExample: whatsapp

integrationstring · iri-referenceOptionalExample: "/api/integrations/whatsapp

isAuthorizedbooleanOptional

sharePastHistorybooleanOptional

reconnectUrlstring · nullableOptional

createdAtstring · date-timeOptional

disconnectedAtstring · nullableOptional

historySyncUntilstring · nullableOptional

clientIdstring · nullableOptionalExample: e6a2e786-2ce0-444a-b08c-ca21ed816bf0

idstring · nullableOptionalExample: e6a2e786-2ce0-444a-b08c-ca21ed816bf0

400

Invalid input

application/ld+jsonapplication/problem+jsonapplication/json

403

Forbidden

application/ld+jsonapplication/problem+jsonapplication/json

404

Not found

application/ld+jsonapplication/problem+jsonapplication/json

422

An error occurred

application/ld+jsonapplication/problem+jsonapplication/json

put

/api/accounts/{id}

HTTPcURLJavaScriptPython

PUT /api/accounts/{id} HTTP/1.1
Host: app.inboxcomponents.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/ld+json
Accept: */*
Content-Length: 481

{
  "username": "Michael Scott",
  "description": "Regional Manager at Dunder Mifflin",
  "avatarUrl": "https://example.com/avatars/michael_scott.png",
  "accountType": "whatsapp",
  "integrationLogo": "whatsapp",
  "integration": "\"/api/integrations/whatsapp",
  "isAuthorized": true,
  "sharePastHistory": true,
  "reconnectUrl": null,
  "createdAt": "2026-03-21T12:09:48.744Z",
  "disconnectedAt": null,
  "historySyncUntil": null,
  "clientId": "e6a2e786-2ce0-444a-b08c-ca21ed816bf0",
  "id": "e6a2e786-2ce0-444a-b08c-ca21ed816bf0"
}

application/ld+jsonapplication/json

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "username": "Michael Scott",
  "description": "Regional Manager at Dunder Mifflin",
  "avatarUrl": "https://example.com/avatars/michael_scott.png",
  "accountType": "whatsapp",
  "integrationLogo": "whatsapp",
  "integration": "\"/api/integrations/whatsapp",
  "isAuthorized": true,
  "sharePastHistory": true,
  "reconnectUrl": null,
  "createdAt": "2026-03-21T12:09:48.744Z",
  "disconnectedAt": null,
  "historySyncUntil": null,
  "clientId": "e6a2e786-2ce0-444a-b08c-ca21ed816bf0",
  "id": "e6a2e786-2ce0-444a-b08c-ca21ed816bf0"
}