---
seo:
  description: >-
    The public Modem API. Authenticate with an organization API key:
    Authorization: Bearer modem_….
sidebar:
  label: Overview
title: Modem API
---
The public Modem API. Authenticate with an organization API key: `Authorization: Bearer modem_…`.

Version 1.0.0

Base URL: `https://api.modem.dev/v1`

## Automations

- [`GET /automation-templates`](/docs/api-reference/automations/automations-list-templates) — List templates.
- [`GET /automation-templates/{slug}`](/docs/api-reference/automations/automations-get-template) — Get template.
- [`POST /automations`](/docs/api-reference/automations/automations-create-public) — Create automation.

## Channels

- [`GET /channels`](/docs/api-reference/channels/channels-list) — List channels.
- [`GET /channels/{channelId}`](/docs/api-reference/channels/channels-get) — Get channel.

## Companies

- [`GET /companies`](/docs/api-reference/companies/companies-list) — List companies.
- [`POST /companies`](/docs/api-reference/companies/companies-create-companies) — Create companies.
- [`PATCH /companies/bulk`](/docs/api-reference/companies/companies-bulk-update) — Bulk update.
- [`POST /companies/merge`](/docs/api-reference/companies/companies-merge) — Merge companies.
- [`GET /companies/{companyId}`](/docs/api-reference/companies/companies-get) — Get company.
- [`PATCH /companies/{companyId}`](/docs/api-reference/companies/companies-update) — Update company.
- [`GET /companies/{companyId}/activity`](/docs/api-reference/companies/companies-get-activity) — Get activity.
- [`GET /companies/{companyId}/history`](/docs/api-reference/companies/companies-get-history) — Get history.
- [`GET /companies/{companyId}/identities`](/docs/api-reference/companies/companies-get-identities) — Get identities.
- [`POST /companies/{companyId}/people`](/docs/api-reference/companies/companies-add-people) — Add people.

## Groups

- [`GET /groups`](/docs/api-reference/groups/groups-list) — List groups.

## Identify

- [`POST /identify`](/docs/api-reference/identify/identities-identify) — Link external records to people and companies.

## People

- [`GET /people`](/docs/api-reference/people/people-list) — List people.
- [`POST /people`](/docs/api-reference/people/people-create-people) — Create people.
- [`PATCH /people/bulk`](/docs/api-reference/people/people-bulk-update) — Bulk update.
- [`POST /people/merge`](/docs/api-reference/people/people-merge) — Merge people.
- [`GET /people/{personId}`](/docs/api-reference/people/people-get) — Get person.
- [`PATCH /people/{personId}`](/docs/api-reference/people/people-update) — Update person.
- [`GET /people/{personId}/history`](/docs/api-reference/people/people-get-history) — Get history.
- [`GET /people/{personId}/identities`](/docs/api-reference/people/people-get-identities) — Get identities.
- [`GET /people/{personId}/source-stats`](/docs/api-reference/people/people-get-source-stats) — Get source stats.

## Stories

- [`GET /stories`](/docs/api-reference/stories/stories-list) — List stories.
- [`GET /stories/{slug}`](/docs/api-reference/stories/stories-get) — Get story.

## Topics

- [`GET /topics`](/docs/api-reference/topics/topics-list) — List topics.
- [`PATCH /topics/bulk`](/docs/api-reference/topics/topics-bulk-update) — Bulk update.
- [`POST /topics/merge`](/docs/api-reference/topics/topics-merge) — Merge topics.
- [`GET /topics/{topicId}`](/docs/api-reference/topics/topics-get) — Get topic.
- [`PATCH /topics/{topicId}`](/docs/api-reference/topics/topics-update) — Update topic.
- [`POST /topics/{topicId}/archive`](/docs/api-reference/topics/topics-archive) — Archive topic.
- [`GET /topics/{topicId}/groups`](/docs/api-reference/topics/topics-get-groups) — Get groups.
- [`GET /topics/{topicId}/history`](/docs/api-reference/topics/topics-get-history) — Get history.
- [`GET /topics/{topicId}/people`](/docs/api-reference/topics/topics-get-topic-persons) — Get topic persons.

## Whoami

- [`GET /whoami`](/docs/api-reference/whoami/whoami-get) — Get current identity.