This API documentation covers all endpoints available in the Waitless API v4.

​
Welcome

Welcome to the Waitless API documentation. Our API enables you to programmatically manage your contacts, actions, projects and audiences. This documentation provides detailed information about the available endpoints and how to use them.

​
Authentication

All API endpoints require authentication using an API key in the header. To obtain an API key:

  1. Go to wt.ls/admin/lists
  2. Click on your project
  3. Navigate to the Integrations tab
  4. Click “Create key”

Then use the key in your API requests:

apiKey: your-api-key

Keep your API keys secure and never expose them in client-side code or public repositories.

​
Rate Limiting

To ensure the stability of our service, API requests are rate limited to:

  • 100 requests per minute for free accounts
  • 1000 requests per minute for pro accounts

If you exceed these limits, you’ll receive a 429 Too Many Requests response.

​
Response Format

All responses are returned in JSON format and include either the requested data or an error object:

// Success response
{
  "data": {
    // Response data
  }
}

// Error response
{
  "error": "Error message"
}

​
Getting Started

To get started with the API, first obtain your API key following the steps above. Then, try making a simple request to list your projects:

curl -X GET "https://api.wt.ls/v4/projects" \
  -H "apiKey: your-api-key"