Ndoto REST API Reference

The Ndoto API is a REST API that lets you build integrations, automate workflows, and extend Ndoto with your own systems. All requests and responses use JSON.

Use the API to programmatically manage conversations, contacts, agents, inboxes, teams, messages, labels, and webhooks.

Base URL

https://app.usendoto.com/api/v1

Authentication

All API requests must include your API access token in the request header:

api_access_token: YOUR_TOKEN

You can find or regenerate your API access token from your profile settings inside Ndoto.

Example

curl https://app.usendoto.com/api/v1/profile \
  -H "api_access_token: YOUR_TOKEN"

Account ID

Most endpoints are scoped to an account. Replace :account_id in endpoint paths with your numeric account ID, visible in your Ndoto URL when logged in.

Response Format

All responses return JSON. Successful responses return the requested resource. Errors return an object with an error field.

{ "error": "Description of what went wrong" }

HTTP Status Codes

Pagination

List endpoints return paginated results. Use the page query parameter to navigate pages.

GET /api/v1/accounts/:account_id/conversations?page=2

Paginated responses include a meta object:

{
  "data": [...],
  "meta": {
    "count": 25,
    "current_page": 2,
    "total_pages": 8
  }
}

API Endpoints

Frequently Asked Questions

How do I authenticate with the Ndoto API? Include your API access token in every request as a header: api_access_token: YOUR_TOKEN. You can find your token in your Ndoto profile settings.

Where do I find my Account ID? Your account ID is visible in the URL when you are logged into Ndoto (e.g., app.usendoto.com/app/accounts/123/... — 123 is your account ID).

Does the API support webhooks? Yes. Ndoto webhooks let you subscribe to real-time events — such as new messages or conversation status changes — and receive HTTP POST notifications to your endpoint.

Related Docs

• Conversations — product-level conversation management
• Contacts — product-level contact management
• Channels — product-level inbox configuration
• Teams & Agents — product-level agent management