Skip to main content
POST
/
bundles
Creating a bundle
curl --request POST \
  --url https://api.peeker.ai/api/partner/v1/bundles \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "monthly_sending_volume": 123
}
'
{
  "data": {
    "id": "bun_01HZX0BU1A2B3C4D5E6F7G8H",
    "name": "Starter — 25k emails/month",
    "monthly_sending_volume": 25000,
    "google_percent": 60,
    "microsoft_percent": 40,
    "customer_price_cents": 9900,
    "currency": "USD",
    "status": "active",
    "effective": {
      "google_percent": 60,
      "microsoft_percent": 40
    },
    "created_at": "2026-05-08T12:00:00Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.peeker.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
default:Bearer pk_test_<your-test-key>
required

Your partner API key. Use pk_live_… against the live system or pk_test_… against the sandbox.

Body

application/json
name
string
required

A friendly name (e.g. "Starter — 25k emails/month").

monthly_sending_volume
integer
required

How many emails per month this bundle is sized for.

google_percent
number

Percent of emails handled by Google. If you set this, also set microsoft_percent (they must add to 100).

microsoft_percent
number
customer_price_cents
integer

What you charge your customer (in cents). Optional — only used to show on the bundle.

currency
string

3-letter currency code, e.g. USD.

Response

201 - application/json

A bundle.

data
object
required
Last modified on May 14, 2026