Embedded Tech API

The Embedded Tech API (also known as the Account Automation API) lets Fetchify partner accounts create and manage sub-client accounts programmatically. Use it to provision new client accounts from your own platform, CRM, or onboarding flow without manual setup in the Fetchify portal.

Base URL: https://api.admin.fetchify.com

View the full OpenAPI specification on SwaggerHub.

Before You Start

You will need:

• A Fetchify partner account
• A Partner API key generated from your account settings

Partner API keys are UUIDs used as Bearer tokens. Generate or regenerate your key from Settings → Partner API Key in the Fetchify account portal.

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer <your-partner-api-key>

Endpoints

List client accounts — GET /client

Returns client accounts linked to your partner account. Supports optional query parameters for paging and filtering:

Parameter	Description
min_id	Minimum client ID to return (inclusive)
max_id	Maximum client ID to return (inclusive)
filters	One or more filters to apply
columns	Columns to include in each result
tags	Tags to include in each result
limit	Maximum number of results to return

Successful responses include a results array and optional paging links (previous, next) for cursor-based navigation.

Example request:

curl -X GET "https://api.admin.fetchify.com/client?limit=2" \
  -H "Authorization: Bearer <your-partner-api-key>" \
  -H "Accept: application/json"

If you omit min_id and max_id, the API returns the first page of your partner's clients, ordered by lowest client_id first, up to 100 results by default.

Example response (200):

{
  "results": [
    {
      "client_id": 4321,
      "client_name": "Example Client 1",
      "account_status": "active",
      "partner_id": 1234
    },
    {
      "client_id": 5678,
      "client_name": "Example Client 2",
      "account_status": "active",
      "partner_id": 1234
    }
  ],
  "paging": {
    "previous": "https://api.admin.fetchify.com/client?columns=%5B%22client_id%22%2C%22client_name%22%2C%22account_status%22%2C%22partner_id%22%5D&max_id=4321",
    "next": "https://api.admin.fetchify.com/client?columns=%5B%22client_id%22%2C%22client_name%22%2C%22account_status%22%2C%22partner_id%22%5D&min_id=5678"
  }
}

Use the paging.next URL to fetch the next page, or pass min_id manually to continue from a specific client ID.

Create a client account — POST /client

Creates a new sub-client account under your partner account.

Example request:

curl -X POST "https://api.admin.fetchify.com/client" \
  -H "Authorization: Bearer <your-partner-api-key>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "client_name": "Example Client 1"
  }'

Request body:

{
  "client_name": "Example Client 1"
}

Example response (201):

{
  "results": [
    {
      "token": "xxxxx-xxxxx-xxxxx-xxxxx",
      "client_id": 4321,
      "client_name": "Example Client 1"
    }
  ]
}

The token in the response is the Fetchify access token for the newly created client account. Store it securely — it is needed for that client's API lookups.

Common Use Cases

• Provision Fetchify accounts automatically when a customer signs up on your platform
• Sync client account lists into your internal admin or billing tools
• Monitor client usage, credit consumption, and account status from your own dashboards

Support

If you need a partner API key or help integrating the Embedded Tech API, contact support@fetchify.com.