Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Attio REST Meta API
description: 'Best-effort OpenAPI 3.1 description of the Attio REST API (v2).
Derived from public documentation at https://docs.attio.com/rest-api and the
documentation index at https://docs.attio.com/llms.txt. Attio is a flexible CRM
with objects, records, lists, attributes and webhooks.'
version: '2'
contact:
name: Attio Docs
url: https://docs.attio.com/rest-api
servers:
- url: https://api.attio.com
description: Attio API production
security:
- bearerAuth: []
- oauth2: []
tags:
- name: Meta
paths:
/v2/meta/identify:
get:
tags:
- Meta
summary: Identify current access token and workspace
operationId: identify
responses:
'200':
description: Identity returned
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Attio API key or OAuth bearer token.
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://app.attio.com/authorize
tokenUrl: https://api.attio.com/oauth/token
scopes:
object_configuration:read: Read object configuration
object_configuration:read-write: Manage object configuration
record_permission:read: Read records
record_permission:read-write: Manage records
list_configuration:read-write: Manage lists
list_entry:read-write: Manage list entries
webhook:read-write: Manage webhooks