aid: twenty
name: Twenty
description: 'Twenty is an open-source CRM platform built as a modern alternative
  to Salesforce, designed for teams that need flexibility, data ownership, and a contemporary
  developer experience. It provides REST and GraphQL APIs covering core CRM operations
  such as managing companies, people, opportunities, notes, tasks, and fully customizable
  objects. Developers can extend Twenty with custom objects, server-side logic, UI
  components, and AI agents as TypeScript packages, all surfaced through the same
  API surface. The platform is available as a cloud service or as a self-hosted deployment
  via Docker Compose, giving teams full control over their data residency and infrastructure.

  '
type: Index
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
url: https://raw.githubusercontent.com/api-evangelist/twenty/refs/heads/main/apis.yml
created: 2026-06-12
modified: 2026-06-12
specificationVersion: '0.19'
tags:
- CRM
- Open Source
- REST
- GraphQL
- Webhooks
- Self-Hosted
- Companies
- People
- Opportunities
- Workflows
- AI Agents
- Custom Objects
apis:
- aid: twenty:core-api
  name: Twenty Core API
  description: 'The Twenty Core API provides REST and GraphQL endpoints for CRUD operations
    on all CRM records including companies, people, opportunities, notes, tasks, and
    any custom objects defined in a workspace. Both interfaces support batch operations
    of up to 60 records per request, filtering, and relation traversal. GraphQL additionally
    supports batch upsert using plural object names. Authentication is via bearer
    token generated from the workspace settings. The API schema is per-tenant and
    adapts automatically as custom objects are added.

    '
  type: Contract
  tags:
  - CRM
  - REST
  - GraphQL
  - Companies
  - People
  - Opportunities
  contact:
  - FN: Twenty Developer Documentation
    url: https://docs.twenty.com/developers/extend/api
  properties:
  - type: Documentation
    url: https://docs.twenty.com/developers/extend/api
  - type: OpenAPI
    url: https://api.twenty.com/open-api/core
  - type: OpenAPI
    url: openapi/twenty-core-api-openapi.yml
  - type: JSONSchema
    url: json-schema/twenty-company.json
  - type: JSONSchema
    url: json-schema/twenty-person.json
  - type: JSONSchema
    url: json-schema/twenty-opportunity.json
  - type: Examples
    url: examples/twenty-create-company.json
  - type: Examples
    url: examples/twenty-list-companies.json
  - type: Examples
    url: examples/twenty-create-custom-object.json
  - url: graphql/twenty-graphql.md
    type: GraphQL
- aid: twenty:metadata-api
  name: Twenty Metadata API
  description: 'The Twenty Metadata API provides REST and GraphQL endpoints for programmatic
    schema management, allowing developers to create, update, and delete custom objects,
    fields, and relations within a workspace. Changes made through the Metadata API
    are immediately reflected in the Core API surface, enabling dynamic data modeling
    at runtime. The base paths are /rest/metadata/ for REST and /metadata/ for GraphQL.

    '
  type: Contract
  tags:
  - Metadata
  - Schema Management
  - Custom Objects
  - REST
  - GraphQL
  contact:
  - FN: Twenty Developer Documentation
    url: https://docs.twenty.com/developers/extend/api
  properties:
  - type: Documentation
    url: https://docs.twenty.com/developers/extend/api
  - type: OpenAPI
    url: https://api.twenty.com/open-api/metadata
  - type: OpenAPI
    url: openapi/twenty-metadata-api-openapi.yml
common:
- type: Website
  url: https://twenty.com
- type: Documentation
  url: https://docs.twenty.com/developers/introduction
- type: GitHubOrg
  url: https://github.com/twentyhq
- type: LinkedIn
  url: https://www.linkedin.com/company/twenty
- type: Blog
  url: https://twenty.com/releases
- type: BlogRSS
  url: https://github.com/twentyhq/twenty/releases.atom
- type: Blogs
  url: blogs/blogs.json
- type: Vocabulary
  url: vocabulary/twenty-vocabulary.yml
- type: JSONLDContext
  url: json-ld/twenty-context.jsonld
- type: Pricing
  url: https://twenty.com/pricing
- type: X
  url: https://x.com/twentycrm
- type: Plans
  url: plans/twenty-plans-pricing.yml
- type: RateLimits
  url: rate-limits/twenty-rate-limits.yml
- type: FinOps
  url: finops/twenty-finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com