---
title: "Create a new contact"
method: POST
path: "/v1/workspaces/{workspaceId}/contacts"
tags: ["contacts"]
---

# Create a new contact

`POST /v1/workspaces/{workspaceId}/contacts`

## Request

- Base URL: `https://api.dispatchtickets.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dispatchtickets.com/v1/workspaces/{workspaceId}/contacts`
- Auth: HTTP bearer

## Request body

- CreateContactDto
  - `email` string, required
  - `name` string
  - `avatarUrl` string
  - `companyId` string
  - `metadata` object: Additional metadata (max 64KB)
  - `notifyEmail` boolean: Whether to send email notifications to this contact

## Response `201`

Contact created

---

[API](https://skmtc.dev/dispatchtickets/apis/dispatch-tickets-api.md) · [All operations](https://skmtc.dev/dispatchtickets/apis/dispatch-tickets-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dispatchtickets/apis/dispatch-tickets-api/revisions/82fc25ab859b?raw)