API: make your first call

InfluencersKit has two kinds of API. The subscriber API reads and changes your list, and needs an API key from the Pro plan. The public endpoints answer public questions and accept signups, with no key.

Before you start

• For the subscriber API: a Pro plan and an API key. Create one under Settings → API keys & webhooks. See API keys.
• Call it from a server or a script, never from a web page.
• All requests go to https://influencerskit.com, over HTTPS.

Your first call

1. 1Put your key in an environment variable, so it stays out of your code.
2. 2Run the request below in a terminal.
3. 3Check that you get status 200 and a JSON page of subscribers.

export IK_API_KEY="ik_live_..."   # your key

curl "https://influencerskit.com/api/subscribers?page=0&size=10" \
  -H "Authorization: Bearer $IK_API_KEY"

Response (shortened):

{
  "content": [
    {
      "id": "6727f0c2a1b2c3d4e5f60718",
      "email": "reader@example.com",
      "firstName": "Ada",
      "lastName": null,
      "status": "active",
      "tags": ["newsletter"],
      "source": "form:your-handle/your-form",
      "subscribedAt": "2026-11-01T09:12:00Z",
      "subscriberCategory": "NORMAL"
    }
  ],
  "totalElements": 1,
  "totalPages": 1,
  "page": 0,
  "size": 10
}

Endpoints a key can call

Add or tag a subscriber

• The response is the subscriber, in the same shape as a row in the list.
• Calling it again for the same address adds the new tags and keeps the old ones. It never changes the status back to active.
• Send "status":"unsubscribed" to record an unsubscribe that happened in your own system.
• Over your plan's subscriber allowance you get 402. See plans.

curl -X POST https://influencerskit.com/api/subscribers \
  -H "Authorization: Bearer $IK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"reader@example.com","firstName":"Ada","tags":["webinar-2026-11"]}'

Rate limits

Responses to a key carry X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (Unix seconds when the minute ends). Over the key limit you get 429 with a Retry-After header in seconds.

Errors

Key errors look like {"message":"Invalid or revoked API key.","status":401,"code":"INVALID_API_KEY"}.

Public endpoints, no key

• A public subscribe never reactivates an unsubscribed or bounced address. If it's eligible, the person is emailed a confirmation request instead.
• Store and checkout endpoints (/api/public/{handle}/products, /api/public/checkout/create) are answered on https://your-handle.ikpages.com.