Create API key

curl -X POST https://app.trypost.it/api/api-keys \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "CI/CD Pipeline", "expires_at": "2025-12-31" }'

{ "token": { "id": "a7b8c9d0-e1f2-3a4b-5c6d-7e8f9a0b1c2d", "name": "CI/CD Pipeline", "last_used_at": null, "expires_at": "2025-12-31T00:00:00+00:00", "created_at": "2025-01-14T12:00:00+00:00" }, "plain_token": "9f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a..." }

curl -X POST https://app.trypost.it/api/api-keys \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "CI/CD Pipeline", "expires_at": "2025-12-31" }'

Request

Requires manage team permission on the workspace (Owner / Admin). Members and Viewers get 403.

string

required

The API key name. Maximum 255 characters.

string

Optional expiration. Any date string the server can parse (e.g. 2026-12-31, 2026-12-31T15:00:00Z), must be today or later (after_or_equal:today). Date-only values are stored as end of that day. Omit for a non-expiring key.

Response

Returns 201 with the new key plus the plain token. The plain token is shown only here — store it immediately.

object

Same shape as one entry in GET /api-keys — id, name, last_used_at, expires_at, created_at (all timestamps ISO 8601).

string

The opaque bearer token to send in Authorization: Bearer …. Never returned again.

Copy the plain_token immediately after creation. TryPost stores a hash of your API key, not the key itself. If you lose it, you’ll need to create a new one.

curl -X POST https://app.trypost.it/api/api-keys \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "CI/CD Pipeline",
    "expires_at": "2025-12-31"
  }'

{
  "token": {
    "id": "a7b8c9d0-e1f2-3a4b-5c6d-7e8f9a0b1c2d",
    "name": "CI/CD Pipeline",
    "last_used_at": null,
    "expires_at": "2025-12-31T00:00:00+00:00",
    "created_at": "2025-01-14T12:00:00+00:00"
  },
  "plain_token": "9f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a..."
}

Overview

Posts

Platforms

Workspace

Signatures

Labels

Social Accounts

API Keys

Request

Response

​Request

​Response

Request

Response