Quickstart

Get started with the TimelinesAI API in just a few steps.

Prerequisites

A TimelinesAI account with at least one connected WhatsApp number

Basic familiarity with REST APIs

Step 1: Get your API token

Go to app.timelines.ai and sign in to your account.

Navigate to API settings

Click Integrations → Public API in the left sidebar.

Copy your token

Click Copy to copy your API token. Keep this secure—it provides full access to your workspace.

Never share your API token publicly or commit it to version control. Use environment variables in production.

Step 2: Test your connection

Verify your token works by listing your WhatsApp accounts:

curl -X GET "https://app.timelines.ai/integrations/api/whatsapp_accounts" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

const response = await fetch('https://app.timelines.ai/integrations/api/whatsapp_accounts', {
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN'
  }
});
const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://app.timelines.ai/integrations/api/whatsapp_accounts',
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'}
)
print(response.json())

You should see a response like:

{
  "status": "ok",
  "data": [
    {
      "id": "14155551234@s.whatsapp.net",
      "phone": "+14155551234",
      "name": "Business WhatsApp",
      "connected": true
    }
  ]
}

Step 3: Send your first message

Now send a message to a phone number:

curl -X POST "https://app.timelines.ai/integrations/api/messages" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+14155559999",
    "text": "Hello from TimelinesAI API! 🎉"
  }'

const response = await fetch('https://app.timelines.ai/integrations/api/messages', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phone: '+14155559999',
    text: 'Hello from TimelinesAI API! 🎉'
  })
});
const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://app.timelines.ai/integrations/api/messages',
    headers={
        'Authorization': 'Bearer YOUR_API_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'phone': '+14155559999',
        'text': 'Hello from TimelinesAI API! 🎉'
    }
)
print(response.json())

Replace +14155559999 with a real phone number. The recipient must have WhatsApp installed.

Success response:

{
  "status": "ok",
  "data": {
    "message_uid": "a5bbb005-37f2-402c-96fa-e479a2e09b02"
  }
}

Messages are queued and sent asynchronously. Use the message_uid to track delivery status.

Step 4: Check message status

Track your message delivery:

curl -X GET "https://app.timelines.ai/integrations/api/messages/a5bbb005-37f2-402c-96fa-e479a2e09b02/status_history" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

const response = await fetch(
  'https://app.timelines.ai/integrations/api/messages/a5bbb005-37f2-402c-96fa-e479a2e09b02/status_history',
  {
    headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
  }
);
const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://app.timelines.ai/integrations/api/messages/a5bbb005-37f2-402c-96fa-e479a2e09b02/status_history',
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'}
)
print(response.json())

Next steps

Send attachments

Learn to send images and documents

Set up webhooks

Receive real-time notifications

Manage chats

Organize and assign conversations

API Reference

Explore all endpoints

Getting Started

Use Cases

Quickstart

Quickstart

Prerequisites

Step 1: Get your API token

Step 2: Test your connection

Step 3: Send your first message

Step 4: Check message status

Next steps

Send attachments

Set up webhooks

Manage chats

API Reference

​Quickstart

​Prerequisites

​Step 1: Get your API token

​Step 2: Test your connection

​Step 3: Send your first message

​Step 4: Check message status

​Next steps

Send attachments

Set up webhooks

Manage chats

API Reference

Quickstart

Prerequisites

Step 1: Get your API token

Step 2: Test your connection

Step 3: Send your first message

Step 4: Check message status

Next steps