---
title: "Create an account"
method: POST
path: "/v3/contact-accounts"
tags: ["Accounts"]
---

# Create an account

`POST /v3/contact-accounts`

<small>_Requires the `contacts:write` scope (or a broader one that includes it)._</small>

Creates a new account.

## Request body

- object — Request body for creating a contact account
  - `name` string, required — Contact account name
  - `description` string, nullable — Optional description
  - `domainName` string, nullable — Primary domain name
  - `domainSecondary` string, nullable — Secondary domain name
  - `industry` string, nullable — Industry of the company
  - `companySize` 'Empty' | 'SelfEmployed' | '2-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1001-5000' | '5001-10000' | '10001+', nullable — Company size range
  - `country` string, nullable — Country of the company
  - `state` string, nullable — State or province
  - `city` string, nullable — City
  - `timeZoneId` string, nullable — Time zone identifier
  - `linkedInUrl` string, nullable — LinkedIn profile URL
  - `phone` string, nullable — Phone number
  - `twitterUrl` string, nullable — Twitter profile URL
  - `logoUrl` string, nullable — Company logo URL
  - `email` string, nullable — Contact email address

## Response `201`

Account created successfully

- object — A single contact account, including the resolved email provider
  - `id` integer — Unique identifier of the contact account
  - `ownerUserId` integer — ID of the user who owns this contact account
  - `name` string — Contact account name
  - `description` string, nullable — Optional description of the contact account
  - `domainName` string, nullable — Primary domain name
  - `domainSecondary` string, nullable — Secondary domain name
  - `industry` string, nullable — Industry of the company
  - `companySize` 'Empty' | 'SelfEmployed' | '2-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1001-5000' | '5001-10000' | '10001+', nullable — Company size range
  - `country` string, nullable — Country of the company
  - `state` string, nullable — State or province
  - `city` string, nullable — City
  - `timeZoneId` string, nullable — Time zone identifier
  - `linkedInUrl` string, nullable — LinkedIn profile URL
  - `phone` string, nullable — Phone number
  - `twitterUrl` string, nullable — Twitter profile URL
  - `logoUrl` string, nullable — Company logo URL
  - `email` string, nullable — Contact email address
  - `emailProvider` 'other' | 'gSuite' | 'office' | 'zoho' | 'mimecast' | 'proofpoint' | 'yandex' | 'ovh' | 'goDaddy' | 'ionos' | 'gandi' | 'hostinger' | 'oneAndOne' | 'amazon' | 'barracuda' | 'spamexperts' | 'hotmail' | 'liveCom' | 'yahoo' | 'bloomberg' | 'gmail' | 'outlook' | 'ciscoSecureEmail' | 'titanMail' | 'protonmail' | 'namecheap' | 'appleMail' | 'linkedin', nullable — Email hosting provider for the account's primary domain, resolved from the domain's MX records. `null` when the account has no domain or the provider could not be determined.
  - `stage` object, nullable — Current stage of the contact account
    - `id` integer — Stage identifier
    - `name` string — Stage name
    - `colorId` integer — Color identifier for the stage
  - `linkedProspectsCount` integer — Number of contacts linked to this account
  - `createdDate` string, date-time — Date when the account was created
  - `lastActivityDate` string, date-time — Date of the last activity on this account

## Other responses

- `400` — Validation failure on the request body, or a business-rule rejection (e.g. invalid field combination).
- `401` — Unauthorized. The response body is empty; check the `WWW-Authenticate` header for the expected scheme.
- `403` — User lacks permission to create accounts
- `429` — Too Many Requests

---

[API](https://skmtc.net/reply/apis/reply-api.md) · [All operations](https://skmtc.net/reply/apis/reply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reply/reply-api/revisions/1c3d32eaf95e/schema)