Kit

Kit Account API

Account, creator profile, and account-level statistics

GitHub OpenAPI

Operations 5

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 /account View my Kit account and user details · Get Account #
Ask an LLM
“Which Kit account and user does my API key belong to?”
“Can I look up my account name and the signed-in user's email through the API?”
Tell an agent
Show me the account and user details for my Kit login.
Confirm which account my current API credentials are connected to.
GET /account/colors List the account's saved brand colors · Get Account Colors #
Ask an LLM
“What color preferences are saved on my email marketing account?”
“Can I see the brand colors configured for my Kit account?”
Tell an agent
List the color preferences currently configured on my account.
Show me my account's saved brand color palette.
PUT /account/colors Update the account's brand colors · Update Account Colors #
Ask an LLM
“How do I change the saved brand colors on my account?”
“Can I replace my account's color preferences with a new palette?”
Tell an agent
Set my account's color preferences to {colors}.
Replace my saved brand color palette with {colors}.
GET /account/email_stats Get email performance stats for the last 90 days · Get Email Stats #
Ask an LLM
“How have my emails performed over the last 90 days?”
“What do my account email stats look like across the past three months?”
Tell an agent
Get my account's email statistics for the last 90 days.
Summarize how my sent emails performed over the past three months.
GET /account/growth_stats Get subscriber growth for a date range · Get Growth Stats #
Ask an LLM
“How many subscribers did I gain or lose over a given period?”
“Can I see my list growth between two specific dates?”
Tell an agent
Show my subscriber growth from {starting} to {ending}.
Report how my audience grew since {starting}.

Documentation

📖
Documentation
https://developers.kit.com/v4/api-reference
📖
Authentication
https://developers.kit.com/v4/api-reference/authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/convertkit/refs/heads/main/openapi/convertkit-account-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/convertkit/refs/heads/main/asyncapi/kit-webhooks-asyncapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/convertkit/refs/heads/main/json-schema/convertkit-stats-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/convertkit/refs/heads/main/json-schema/convertkit-colors-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/convertkit/refs/heads/main/json-schema/convertkit-colors-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/convertkit/refs/heads/main/json-schema/convertkit-account-response-schema.json

Other Resources

🔗
Webhooks
https://developers.kit.com/v4/api-reference/webhooks
🔗
Migration
https://developers.kit.com/v4/api-reference/v3-to-v4-upgrade-guide

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/convertkit:convertkit-account-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

convertkit-account-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Kit API V4 Account API
  description: Kit (formerly ConvertKit) API V4 for email marketing and the creator economy. Manage subscribers, broadcasts, tags, custom fields, forms, and account-level statistics. Supports OAuth 2.0 and API key authentication.
  version: v4
  contact:
    name: Kit Developer Support
    url: https://developers.kit.com/v4/api-reference
servers:
- url: https://api.kit.com/v4
  description: Kit API V4 production server
security:
- ApiKeyAuth: []
- OAuth2: []
tags:
- name: Account
  description: Account, creator profile, and account-level statistics
paths:
  /account:
    get:
      operationId: getAccount
      summary: Get Account
      description: Retrieve the current Kit account and associated user information.
      tags:
      - Account
      responses:
        '200':
          description: Successful response with account details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /account/colors:
    get:
      operationId: getAccountColors
      summary: Get Account Colors
      description: List configured color preferences for the account.
      tags:
      - Account
      responses:
        '200':
          description: Successful response with color preferences
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ColorsResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
    put:
      operationId: updateAccountColors
      summary: Update Account Colors
      description: Update the color preferences for the account.
      tags:
      - Account
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ColorsRequest'
      responses:
        '200':
          description: Updated color preferences
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ColorsResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /account/email_stats:
    get:
      operationId: getAccountEmailStats
      summary: Get Email Stats
      description: Retrieve email statistics for the last 90 days.
      tags:
      - Account
      responses:
        '200':
          description: Successful response with email statistics
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatsResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /account/growth_stats:
    get:
      operationId: getAccountGrowthStats
      summary: Get Growth Stats
      description: Retrieve subscriber growth metrics for a specified period.
      tags:
      - Account
      parameters:
      - name: starting
        in: query
        required: false
        schema:
          type: string
          format: date
        description: Start of the reporting window (YYYY-MM-DD)
      - name: ending
        in: query
        required: false
        schema:
          type: string
          format: date
        description: End of the reporting window (YYYY-MM-DD)
      responses:
        '200':
          description: Successful response with growth statistics
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatsResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        errors:
          type: array
          items:
            type: string
    Account:
      type: object
      properties:
        name:
          type: string
        plan_type:
          type: string
        primary_email_address:
          type: string
    AccountResponse:
      type: object
      properties:
        account:
          $ref: '#/components/schemas/Account'
    StatsResponse:
      type: object
      properties:
        stats:
          type: object
          additionalProperties: true
    ColorsResponse:
      type: object
      properties:
        colors:
          type: array
          items:
            type: string
    ColorsRequest:
      type: object
      properties:
        colors:
          type: array
          items:
            type: string
  responses:
    Unauthorized:
      description: Missing or invalid credentials
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Kit-Api-Key
      description: Personal API key issued from the Kit developer portal
    OAuth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://app.kit.com/oauth/authorize
          tokenUrl: https://api.kit.com/oauth/token
          scopes: {}