API Documentation

Lorem ipsum dolor sit amet. Build custom integrations with Tajo's powerful REST API.

API v2.0 REST JSON

Quick Start

1. Get Your API Key

Duis aute irure dolor. Navigate to Settings → API Keys in your Tajo dashboard to generate an API key.

2. Make Your First Request

curl https://api.tajo.io/v2/customers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

3. Handle the Response

{
  "data": [
    {
      "id": "cust_123",
      "email": "[email protected]",
      "created_at": "2025-01-01T00:00:00Z"
    }
  ],
  "meta": {
    "total": 100,
    "page": 1
  }
}

Base URL

https://api.tajo.io/v2

All API requests should be made to this base URL

Authentication

Authorization: Bearer YOUR_API_KEY

Include your API key in the Authorization header

API Endpoints

GET /customers

Sed ut perspiciatis unde. Retrieve a list of all customers.

View Example

GET /v2/customers?page=1&limit=20

POST /customers

Nemo enim ipsam voluptatem. Create a new customer.

View Example

POST /v2/customers
{
  "email": "[email protected]",
  "first_name": "John",
  "last_name": "Doe",
  "tags": ["vip", "newsletter"]
}

GET /campaigns

Neque porro quisquam est. Retrieve all campaigns.

View Example

GET /v2/campaigns?status=active

POST /events

Ut enim ad minima veniam. Track custom events for customers.

View Example

POST /v2/events
{
  "customer_id": "cust_123",
  "event_name": "product_viewed",
  "properties": {
    "product_id": "prod_456",
    "price": 49.99
  }
}

Webhooks

Quis autem vel eum iure. Configure webhooks to receive real-time notifications about events in your Tajo account.

Available Events

customer.created

customer.updated

order.created

campaign.sent

email.opened

email.clicked

Webhook Payload Example

{
  "event": "customer.created",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "id": "cust_789",
    "email": "[email protected]",
    "created_at": "2025-01-15T10:30:00Z"
  }
}