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

# Create contact

`POST /public/v2/contacts`

Required permission: Admin Only - API User Management, Edit.<br/>Creates the contact if it is new, and adds the contact to the authenticated account.

## Request body

- CreateContactOnAccountRequest
  - `firstName` string, required — Contact first name.
  - `lastName` string, required — Contact last name.
  - `roles` string[], required — Contact roles on account.
  - `email` string, required — Contact email.
  - `phoneNumber` string, required — Contact phone number.
  - `locale` string, required — Contact locale.

## Response `200`

Contact has been created and added to the account with the requested roles.

- UserResponseServiceResponse
  - `errors` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `warnings` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `information` string[], nullable
  - `isValid` boolean
  - `content` UserResponse
    - `subjectId` string, required — Unique subject ID given to this user.
    - `email` string, required — User email.
    - `roles` string[], required — List of User roles which map to permissions on the specified account.

## Other responses

- `400` — Bad request. Invalid or missing parameter
- `401` — Unauthorized
- `403` — user_lacks_required_permission
- `422` — Failed to create the contact and add it to the account with the correct roles.

---

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