---
title: "Create a contact"
method: POST
path: "/contacts"
tags: ["Contacts"]
---

# Create a contact

`POST /contacts`

## Request

- Base URL: `https://www.ruddr.io/api/workspace`
- URL: `https://www.ruddr.io/api/workspace/contacts`
- Auth: HTTP bearer

## Request body

- object
  - `firstName` string, required: The first name of the contact. Max 127 characters.
  - `lastName` string, required: The last name of the contact. Max 127 characters.
  - `name` string, required: The full name of the contact. Max 255 characters.
  - `email` string, required: The email address of the contact. Max 255 characters.
  - `title` string, nullable: The job title of the contact. Max 255 characters.
  - `description` string, nullable: A description of the contact. Max 5000 characters.
  - `officePhone` string, nullable: The office phone number of the contact. Max 255 characters.
  - `mobilePhone` string, nullable: The mobile phone number of the contact. Max 255 characters.
  - `fax` string, nullable: The fax number of the contact. Max 255 characters.
  - `websiteUrl` string, nullable: The website URL of the contact. Max 255 characters.
  - `ownerId` string, nullable: The identifier of the member who owns this contact.
  - `practiceId` string, nullable: The identifier of the practice associated with the contact.
  - `businessUnitId` string, nullable: The identifier of the business unit associated with the contact.
  - `timeZoneId` string, nullable: The identifier of the time zone for the contact.
  - `tagIds` string[]: A list of contact tag identifiers to assign to the contact.

## Response `200`

200

- Contact
  - `id` string: The unique identifier for the object.
  - `firstName` string: The first name of the contact.
  - `lastName` string: The last name of the contact.
  - `name` string: The full name of the contact.
  - `email` string: The email address of the contact.
  - `title` string, nullable: The job title of the contact.
  - `description` string, nullable: A description of the contact.
  - `officePhone` string, nullable: The office phone number of the contact.
  - `mobilePhone` string, nullable: The mobile phone number of the contact.
  - `fax` string, nullable: The fax number of the contact.
  - `websiteUrl` string, nullable: The website URL of the contact.
  - `createdAt` string, date-time: The timestamp when the object was created.
  - `createdBy` string, nullable: The identifier of the member who created the contact.
  - `ownerId` string, nullable: The identifier of the member who owns this contact.
  - `practiceId` string, nullable: The identifier of the practice associated with the contact.
  - `businessUnitId` string, nullable: The identifier of the business unit associated with the contact.
  - `timeZoneId` string, nullable: The identifier of the time zone for the contact.
  - `tags` object[]: The contact tags assigned to the contact.
    - `id` string: The unique identifier for the object.
    - `name` string: The name of the contact tag.
  - `salesforceId` string, nullable: The Salesforce identifier for the contact.
  - `hubspotId` string, nullable: The HubSpot identifier for the contact.

## Other responses

- `400`: 400
- `409`: 409

---

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