All Copper API requests require three headers: X-PW-AccessToken set to YOUR_TOKEN, X-PW-Application set to developer_api, and X-PW-UserEmail set to the email address of the Copper user associated with the token
Generate the API token in Copper under Settings > Integrations > API Keys
To search people, POST to /v1/people/search with a JSON body containing filters such as name, email, or custom fields, plus page_size and page_number for pagination
To retrieve a single person, GET /v1/people/{id}
To search leads, POST to /v1/leads/search with a similar filter body
Known gotchas
All three custom headers (token, application, and email) are mandatory — omitting any one returns a 401 regardless of the token validity
The X-PW-UserEmail must match the account that generated the token exactly — using a different user's email with another user's token will fail
Copper's API uses 1-based page_number pagination, not cursor-based; there is no nextLink — increment page_number until the result set is smaller than page_size
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp