Developer API

The graph8 Developer API gives you programmatic access to your contacts, companies, and lists. Authenticate with an org API key and start building integrations in minutes.

Base URL

https://be.graph8.com/api/v1

All endpoints are relative to this base URL. For example, to list contacts:

GET https://be.graph8.com/api/v1/contacts

Quick Example

cURL

curl "https://be.graph8.com/api/v1/contacts?limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://be.graph8.com/api/v1"

response = requests.get(
    f"{BASE_URL}/contacts",
    headers={"Authorization": f"Bearer {API_KEY}"},
    params={"limit": 5}
)

data = response.json()
for contact in data["data"]:
    print(f"{contact['first_name']} {contact['last_name']} - {contact['work_email']}")

TypeScript

const API_KEY = "YOUR_API_KEY";
const BASE_URL = "https://be.graph8.com/api/v1";

const response = await fetch(`${BASE_URL}/contacts?limit=5`, {
  headers: { Authorization: `Bearer ${API_KEY}` }
});

const { data } = await response.json();
data.forEach(c => console.log(`${c.first_name} ${c.last_name} - ${c.work_email}`));

Resources

Authentication

Create API keys and authenticate your requests. Get started

Contacts

List, create, update, and delete contacts. View reference

Companies

Manage companies and their associated contacts. View reference

Lists

Create lists and manage list membership. View reference

Reference

Pagination

Response envelope and pagination patterns. Learn more

Errors

Error codes and handling strategies. Learn more

Rate Limits

Request limits and backoff strategies. Learn more

Interactive API Reference

For a live, interactive view of all endpoints with request/response schemas, visit the OpenAPI docs:

Open Interactive API Docs →

You can test endpoints directly from the browser — authenticate with your API key and execute requests in real time.

Response Format

All responses use a standard envelope:

{
  "data": { ... },
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 243,
    "has_next": true
  }
}

Single-resource responses include data without pagination. See Pagination for details.