Pinto API Documentation

The Pinto API lets you connect your app to Notion, Google, Slack, and more using a unified schema and authentication model.

Authentication

Every request to the Pinto API requires your API key in the header:

curl -X GET "https://api.pinto.dev/v1/user"
-H "Authorization: Bearer YOUR_API_KEY"

You can generate your key from the dashboard.

Retrieve account information for the current API key.

Response:
{
  "id": "usr_123",
  "email": "dev@pinto.dev",
  "plan": "pro"
}

Initiate a new connection to an external service (e.g. Notion, Slack).

Body:
{
  "provider": "notion",
  "access_token": "user-access-token"
}

Response:
{
  "connection_id": "conn_abc123",
  "status": "connected"
}

Fetch data from a connected service through Pinto.

Response:
{
  "data": [
    {
      "id": "item_1",
      "title": "Design Docs",
      "updated_at": "2025-11-10T10:00:00Z"
    }
  ]
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "The API key provided is invalid."
  }
}

All errors follow this format. Check your key and parameters before retrying.