POST/api/v1/documents/{slug}/access/people

Share with a person

Gives one person access by email, and optionally emails them. If the email fails, the access stays: the response says whether it was sent.

API token required60 per hour per IP

Guide: Share with people

Code samples and Try it

Path parameters

slugstringRequired
The document's address: the part after markdrop.in/.

Request body

application/json, required

emailstring (email)Required
The person's email address. They don't need an account yet.
role"viewer" | "editor"
viewer can open it; editor can also change it. Default "viewer".
notifyboolean
Email them a link. Default true.
messagestring
A note included in the email. Up to 500 characters.

Responses

201Created.
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.

201 response: 7 fields (GrantResponse)

emailstring
role"viewer" | "editor"
created_atstring (date-time)
ISO 8601, for example 2026-11-30T12:00:00Z.
granted_by_emailstring | null
notifiedboolean
Default false.
activeboolean
Default true.
effective_role"viewer" | "editor" | null

curl -X POST https://api.markdrop.in/api/v1/documents/k3x9q2m/access/people \ -H "Authorization: Bearer $MARKDROP_TOKEN" \ -H "Content-Type: application/json" \ -d '{"email":"sam@example.com","role":"viewer","notify":true}'

const res = await fetch("https://api.markdrop.in/api/v1/documents/k3x9q2m/access/people", { method: "POST", headers: { Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ "email": "sam@example.com", "role": "viewer", "notify": true }), }); const data = await res.json();

import os import requests r = requests.post( "https://api.markdrop.in/api/v1/documents/k3x9q2m/access/people", headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"}, json={ "email": "sam@example.com", "role": "viewer", "notify": True, }, ) r.raise_for_status() print(r.json())