Introduction

The Pathbound API v1 gives you programmatic access to manage contacts, companies, identities, actions, and AI agents within the Pathbound platform.

Base URL

All API v1 endpoints are served under:

https://api.pathbound.io/v1

Key Concepts

Concept	Description
Contacts	People enriched with profile and event data.
Companies	Organizations tied to contacts, identified by domain.
Identities	User profiles used for outreach channels such as LinkedIn.
Actions	Outreach operations (emails, LinkedIn messages) you can schedule.
Agents	AI-powered automations that run playbooks on your contacts.

Quick Start

1. Create an API key in the Pathbound dashboard under Settings → API Keys.
2. Authenticate every request with the Authorization: Bearer <api_key> header.
3. Make your first call:

curl https://api.pathbound.io/v1/auth/status \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "status": "success",
  "authenticated": true,
  "user": {
    "user_id": "abc123",
    "email": "you@example.com",
    "first_name": "Jane",
    "last_name": "Doe",
    "tenant_id": "tenant_xyz"
  }
}

Error Format

All error responses follow a consistent shape:

{
  "status": "error",
  "error": "A human-readable message",
  "details": [],
  "timestamp": "2025-01-01T00:00:00.000Z"
}

Rate Limits

The API enforces a global rate limit of 100 requests per 15-minute window per API key. Exceeding this limit returns a 429 Too Many Requests response.

Next Steps

• Authentication — learn about API keys and scopes.
• Actions API — schedule and manage outreach.
• Contacts API — create and query your CRM contacts.