---
title: "Create a contact"
method: POST
path: "/partners/{partnerId}/contacts"
tags: ["Partner Contacts"]
---

# Create a contact

`POST /partners/{partnerId}/contacts`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/partners/{partnerId}/contacts`
- Auth: HTTP bearer

Create a new contact for a partner

## Path parameters

- `partnerId` string, uuid, required

## Request body

- object
  - `first_name` string, required
  - `last_name` string, required
  - `email` string, email, required
  - `job_title` string

## Response `201`

Contact created successfully

- object
  - `success` boolean
  - `data` PartnerContact
    - `id` string, uuid
    - `partner_id` string, uuid
    - `first_name` string
    - `last_name` string
    - `email` string
    - `job_title` string
    - `created_at` string, date-time

## Other responses

- `401`: Unauthorized
- `404`: Partner not found
- `422`: Validation error

---

[API](https://skmtc.dev/withmedley/apis/medley-api.md) - [All operations](https://skmtc.dev/withmedley/apis/medley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withmedley/apis/medley-api/revisions/40aaac5ca6bd?raw)
