Kinde

Kinde Subscribers API

The Subscribers API from Kinde — 2 operation(s) for subscribers.

GitHub OpenAPI

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/v1/subscribers List subscribers · List Subscribers #
Ask an LLM
“Who has subscribed to my mailing list?”
“Can I sort subscribers by email address?”
Tell an agent
List all subscribers.
Show subscribers sorted by {sort}.
POST /api/v1/subscribers Add a subscriber · Create Subscriber #
Ask an LLM
“How do I add someone as a subscriber?”
“What details do I need to create a subscriber?”
Tell an agent
Add subscriber {first_name} {last_name} with email {email}.
Subscribe {email} under the name {first_name} {last_name}.
GET /api/v1/subscribers/{subscriber_id} Get a subscriber · Get Subscriber #
Ask an LLM
“Can I look up one subscriber's record?”
“Where do I see a single subscriber's details?”
Tell an agent
Show subscriber {subscriber_id}.
Get the record for subscriber {subscriber_id}.

Documentation

📖
Documentation
https://docs.kinde.com/kinde-apis/management/
📖
GettingStarted
https://docs.kinde.com/developer-tools/kinde-api/connect-to-kinde-api/
📖
Authentication
https://docs.kinde.com/developer-tools/kinde-api/access-token-for-api/
📖
Documentation
https://docs.kinde.com/kinde-apis/frontend/

Specifications

⚙
OpenAPI
https://artifacts.apis.io/kinde/openapi/kinde-subscribers-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/kinde/json-schema/kinde-user-schema.json
📊
JSONSchema
https://artifacts.apis.io/kinde/json-schema/kinde-organization-schema.json
📊
JSONSchema
https://artifacts.apis.io/kinde/json-schema/kinde-application-schema.json
📊
JSONSchema
https://artifacts.apis.io/kinde/json-schema/kinde-role-schema.json
📊
JSONSchema
https://artifacts.apis.io/kinde/json-schema/kinde-permission-schema.json
📊
JSONSchema
https://artifacts.apis.io/kinde/json-schema/kinde-feature-flag-schema.json
📊
JSONSchema
https://artifacts.apis.io/kinde/json-schema/kinde-webhook-schema.json
📊
JSONStructure
https://artifacts.apis.io/kinde/json-structure/kinde-user-structure.json
📊
JSONStructure
https://artifacts.apis.io/kinde/json-structure/kinde-organization-structure.json

Other Resources

🔗
OpenAPICanonical
https://api-spec.kinde.com/kinde-management-api-spec.yaml
🔗
SpectralRules
https://artifacts.apis.io/kinde/rules/kinde-rules.yml
🔗
Examples
https://artifacts.apis.io/kinde/examples/kinde-create-user-example.json
🔗
Examples
https://artifacts.apis.io/kinde/examples/kinde-create-organization-example.json
🔗
Examples
https://artifacts.apis.io/kinde/examples/kinde-create-application-example.json
🔗
Examples
https://artifacts.apis.io/kinde/examples/kinde-create-role-example.json
🔗
Examples
https://artifacts.apis.io/kinde/examples/kinde-create-feature-flag-example.json
🔗
Examples
https://artifacts.apis.io/kinde/examples/kinde-create-webhook-example.json
🔗
OpenAPICanonical
https://api-spec.kinde.com/kinde-frontend-api-spec.yaml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/kinde:kinde-subscribers-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

kinde-subscribers-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: '1'
  title: Kinde Management Subscribers API
  description: 'Provides endpoints to manage your Kinde Businesses.


    ## Intro


    ## How to use


    1. Set up and authorize a machine-to-machine (M2M) application.


    2. Generate a test access token


    3. Test request any endpoint using the test token'
  termsOfService: https://docs.kinde.com/trust-center/agreements/terms-of-service/
  contact:
    name: Kinde Support Team
    email: support@kinde.com
    url: https://docs.kinde.com
servers:
- url: https://{subdomain}.kinde.com
  variables:
    subdomain:
      default: your_kinde_subdomain
      description: The subdomain generated for your business on Kinde.
tags:
- name: Subscribers
  x-displayName: Subscribers
paths:
  /api/v1/subscribers:
    servers: []
    get:
      tags:
      - Subscribers
      operationId: GetSubscribers
      x-scope: read:subscribers
      description: 'The returned list can be sorted by full name or email address

        in ascending or descending order. The number of records to return at a time can also be controlled using the `page_size` query

        string parameter.


        read:subscribers'
      summary: List Subscribers
      parameters:
      - name: sort
        in: query
        description: Field and order to sort the result by.
        schema:
          type:
          - string
          - 'null'
          enum:
          - name_asc
          - name_desc
          - email_asc
          - email_desc
      - name: page_size
        in: query
        description: Number of results per page. Defaults to 10 if parameter not sent.
        schema:
          type:
          - integer
          - 'null'
      - name: next_token
        in: query
        description: A string to get the next page of results if there are more results.
        schema:
          type:
          - string
          - 'null'
      responses:
        '200':
          description: Subscriber successfully retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/get_subscribers_response'
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/get_subscribers_response'
        '403':
          description: Bad request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_response'
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/error_response'
        '429':
          description: Request was throttled.
      security:
      - kindeBearerAuth: []
    post:
      tags:
      - Subscribers
      operationId: CreateSubscriber
      x-scope: create:subscribers
      description: 'Create subscriber.


        create:subscribers'
      summary: Create Subscriber
      parameters:
      - name: first_name
        in: query
        description: Subscriber's first name.
        required: true
        schema:
          type: string
      - name: last_name
        in: query
        description: Subscriber's last name.
        required: true
        schema:
          type:
          - string
          - 'null'
      - name: email
        in: query
        description: The email address of the subscriber.
        required: true
        schema:
          type:
          - string
          - 'null'
      responses:
        '201':
          description: Subscriber successfully created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/create_subscriber_success_response'
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/create_subscriber_success_response'
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_response'
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/error_response'
        '403':
          description: Invalid credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_response'
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/error_response'
        '429':
          description: Request was throttled.
      security:
      - kindeBearerAuth: []
  /api/v1/subscribers/{subscriber_id}:
    servers: []
    get:
      tags:
      - Subscribers
      operationId: GetSubscriber
      x-scope: read:subscribers
      description: 'Retrieve a subscriber record.


        read:subscribers'
      summary: Get Subscriber
      parameters:
      - name: subscriber_id
        in: path
        description: The subscriber's id.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Subscriber successfully retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/get_subscriber_response'
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/get_subscriber_response'
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_response'
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/error_response'
        '403':
          description: Invalid credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_response'
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/error_response'
        '429':
          description: Request was throttled.
      security:
      - kindeBearerAuth: []
components:
  schemas:
    get_subscribers_response:
      type: object
      properties:
        code:
          type: string
          description: Response code.
        message:
          type: string
          description: Response message.
        subscribers:
          type: array
          items:
            $ref: '#/components/schemas/subscribers_subscriber'
        next_token:
          description: Pagination token.
          type: string
    get_subscriber_response:
      type: object
      properties:
        code:
          type: string
          description: Response code.
        message:
          type: string
          description: Response message.
        subscribers:
          type: array
          items:
            $ref: '#/components/schemas/subscriber'
    error:
      type: object
      properties:
        code:
          type: string
          description: Error code.
        message:
          type: string
          description: Error message.
    create_subscriber_success_response:
      type: object
      properties:
        subscriber:
          type: object
          properties:
            subscriber_id:
              type: string
              description: A unique identifier for the subscriber.
    error_response:
      type: object
      properties:
        errors:
          type: array
          items:
            $ref: '#/components/schemas/error'
    subscribers_subscriber:
      type: object
      properties:
        id:
          type: string
        email:
          type: string
        full_name:
          type: string
        first_name:
          type: string
        last_name:
          type: string
    subscriber:
      type: object
      properties:
        id:
          type: string
        preferred_email:
          type: string
        first_name:
          type: string
        last_name:
          type: string
  securitySchemes:
    kindeBearerAuth:
      description: 'Requires an access token obtained using the client_credentials flow.

        '
      type: http
      scheme: bearer
      bearerFormat: JWT