POST/api/v1/me/tokens

Create an API token

Creates an API token (mdk_…). It is shown only in this response.

API token required20 per hour per IP

Guide: API tokens

Code samples and Try it

Request body

application/json, required

namestring
A name to recognise it by, like the script or device that uses it. Up to 80 characters. Default "API token".

Responses

200OK.
401No token, or the token is revoked or mistyped.
422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
429Too many requests from your IP address. Wait the seconds in Retry-After.

200 response: 6 fields (ApiTokenCreateResponse)

idstring
namestring
prefixstring
created_atstring (date-time)
ISO 8601, for example 2026-11-30T12:00:00Z.
last_used_atstring (date-time) | null
ISO 8601, for example 2026-11-30T12:00:00Z.
tokenstring
The token. Shown only in this response: store it now.

bash

curl -X POST https://api.markdrop.in/api/v1/me/tokens \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Build server"}'

javascript

const res = await fetch("https://api.markdrop.in/api/v1/me/tokens", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "Build server"
  }),
});
const data = await res.json();

python

import os

import requests

r = requests.post(
    "https://api.markdrop.in/api/v1/me/tokens",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
    json={"name": "Build server"},
)
r.raise_for_status()
print(r.json())

Try it

API token

Kept in this tab only. Without one, the command reads $MARKDROP_TOKEN. Create a token

name

Your request

curl -X POST https://api.markdrop.in/api/v1/me/tokens \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Build server"}'

The API accepts browser requests only from markdrop.in, so this page can’t send it for you. Run the command in a terminal.

Did this page help?