---
title: "Create an Ideal Customer Profile"
method: POST
path: "/icps"
tags: ["ICPs"]
---

# Create an Ideal Customer Profile

`POST /icps`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/icps`
- Auth: HTTP bearer

Stores a manually-authored ICP scoped to the caller's workspace. Set makePrimary to promote it to the workspace's active profile.

## Request body

- ModelsCreateICPRequest
  - `companySizes` string[]
  - `industries` string[]
  - `keywords` string[]
  - `locations` string[]
  - `makePrimary` boolean: MakePrimary promotes this profile to the workspace's active one, demoting any existing primary.
  - `name` string, required
  - `seniorities` string[]
  - `summary` string: Summary is one to three sentences describing who the workspace sells to.
  - `titles` string[]

## Response `201`

The created profile

- ModelsICPResult
  - `icp` ModelsICPResponse
    - `audienceSizedAt` string: AudienceSizedAt is when the audience size was last refreshed (RFC3339), or null when it has never been sized.
    - `companySizes` string[]
    - `createdAt` string
    - `estimatedAudienceSize` integer
    - `id` integer
    - `industries` string[]
    - `isGenerated` boolean: IsGenerated is true while the profile is exactly what the AI proposed; any human edit clears it.
    - `isPrimary` boolean: IsPrimary marks the workspace's active profile. At most one per space.
    - `keywords` string[]
    - `locations` string[]
    - `name` string
    - `personas` ModelsICPPersona[]
      - `seniority` string
      - `title` string
    - `seniorities` string[]
    - `sourceWebsite` string
    - `summary` string
    - `titles` string[]

## Other responses

- `400`: Invalid request body
- `401`: Unauthorized - invalid or missing API key
- `500`: Failed to create the profile

---

[API](https://skmtc.dev/emailchaser/apis/emailchaser-api.md) · [All operations](https://skmtc.dev/emailchaser/apis/emailchaser-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emailchaser/apis/emailchaser-api/revisions/8b114990abb7?raw)