Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kit Tags API

The Tags API from Kit — 6 operation(s) for tags.

Kit Tags API is one of 14 APIs that Kit publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Tags. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and a changelog.

This API exposes 11 operations across 6 paths. It is described by OpenAPI 3.0.3, at version 4.0.

Requests are made against a single base URL, https://api.kit.com.

11 operations 6 paths 0 schemas 3 DELETE2 GET5 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
4.0
Base URL
https://api.kit.com/v4
Authentication
API Key, OAuth 2.0
Resource Areas
1

Authentication & Security 2

Kit Tags API declares 2 security schemes for authenticating requests. An API key is passed in the header as X-Kit-Api-Key (API Key). It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 2 scopes.

  • API Key — Authenticate API requests via an API Key
  • OAuth2 — Authenticate API requests via an OAuth token

Paths & Operations 11

Across 6 paths, the API surfaces 11 operations — 3 DELETE, 2 GET, 5 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Tags 11
POST
/v4/bulk/tags
Bulk create tags
body → 200202401413422
DELETE
/v4/bulk/tags/subscribers
Bulk remove tags from subscribers
→ 200202401413422
POST
/v4/bulk/tags/subscribers
Bulk tag subscribers
body → 200202401413422
GET
/v4/tags
List tags
4 params → 200401
POST
/v4/tags
Create a tag
body → 200201401422
PUT
/v4/tags/{id}
Update tag name
1 param body → 200401404422
DELETE
/v4/tags/{tag_id}/subscribers
Remove tag from subscriber by email address
1 param → 204401404422
GET
/v4/tags/{tag_id}/subscribers
List subscribers for a tag
11 params → 200401404
POST
/v4/tags/{tag_id}/subscribers
Tag a subscriber by email address
1 param body → 200201401404422
DELETE
/v4/tags/{tag_id}/subscribers/{id}
Remove tag from subscriber
2 params → 204401404
POST
/v4/tags/{tag_id}/subscribers/{id}
Tag a subscriber
2 params body → 200201401404

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

convertkit-tags-api-openapi.yml Raw ↑

Other APIs Kit publishes across the network.

Kit Accounts API
Kit Broadcasts API
Kit Custom Fields API
Kit Email Templates API
Kit Forms API
Kit Posts API
Kit Purchases API
Kit Segments API
Kit Sequence Emails API
Kit Sequences API
Kit Snippets API
Kit Subscribers API