---
title: "[BETA] Add a company (async enrichment)"
method: POST
path: "/companies"
tags: ["companies"]
---

# [BETA] Add a company (async enrichment)

`POST /companies`

Submit a single company for discovery and enrichment. Returns 202 with a public_operation_id for polling via GET /operations/{public_operation_id}. Requires company_name, domain, or id.

## Request body

- object
  - `company_name` string — Company display name
  - `domain` string — Company website domain
  - `id` string — Existing PG:AI company UUID
  - `external_id` string — External system id (requires source_system)
  - `source_system` string — Source label for external_id

## Response `202`

Accepted — enrichment queued

- object — Response data

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `402` — Insufficient credits
- `403` — Forbidden
- `500` — Unexpected error

---

[API](https://skmtc.net/getpg/apis/pg-ai-public-api.md) · [All operations](https://skmtc.net/getpg/apis/pg-ai-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getpg/pg-ai-public-api/revisions/cc47d013c073/schema)