Peeker Partner API

Use Partner API v1 to connect provider workspaces and place orders from your own app. For Smartlead, connect the main workspace once. Add client_id only when an order should go to one of its client workspaces.

Provider setup and ordering

See all four provider shapes and the workspace-to-order flow.

Authentication

Create a key, make your first request, and handle errors.

Core flow

Connect a workspace once, then submit orders with its Peeker wrk_... ID. Workspace creation does not use an Idempotency-Key. Each order does.

Connect a Smartlead main workspace

curl -X POST "https://api.peeker.ai/partner/v1/workspaces" \
  -H "Authorization: Bearer pk_test_<your-key>" \
  -H "Content-Type: application/json" \
  --data '
{
	"provider": "smartlead",
	"label": "Agency Smartlead",
	"credentials": {
		"api_key": "<smartlead-main-api-key>"
	}
}'

What you can build

Provider workspaces

Connect EmailBison, Instantly, Smartlead, or PlusVibe once. Reuse wrk_….

Smartlead main and clients

Use one main workspace ID. Add client_id only to client orders.

Orders

Google Workspace and Microsoft 365 for all four providers.

Domains

Buy new domains or import ones the customer already owns.

Pre-warmed pool

Assign warmed Google inventory by exact quantity.

Webhooks

Signed updates for orders, imports, pool, swaps, and more.

Next steps

Authentication

Sandbox key, then GET /me.

Concepts

Lifecycles without reading every endpoint.

Async jobs

What to poll vs subscribe to.

Last modified on August 24, 2026

Provider setup and ordering

Authentication

​Core flow

​What you can build

Provider workspaces

Smartlead main and clients

Orders

Domains

Pre-warmed pool

Webhooks

​Next steps

Authentication

Concepts

Async jobs

Core flow

What you can build

Next steps