---
title: "Create a vendor contact"
method: POST
path: "/vendor/contact/add"
tags: ["vendors"]
---

# Create a vendor contact

`POST /vendor/contact/add`

## Request

- Base URL: `https://cyber-risk.upguard.com/api/public`
- URL: `https://cyber-risk.upguard.com/api/public/vendor/contact/add`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/docs/vendor/contact/add/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new vendor contact for a vendor in your organisation.

The vendor must be monitored. If your account keeps vendors without monitoring them, the vendor can also be one that you keep without monitoring.

Required API key permissions: `VendorRisk` + `ReadWrite` (select when creating API key in Account Settings)

## Request body

- CreateVendorContactV1RequestBody
  - `email_address` string: The email address of the contact.
  - `name` string, required: The full name of the contact.
  - `notes` string: Notes associated with the contact.
  - `phone_mobile` string: The mobile phone number of the contact.
  - `title` string: The job title of the contact.
  - `vendor_id` integer, required: The ID of the vendor this contact belongs to.

## Response `200`

Returns the ID of the created vendor contact.

- CreateVendorContactV1ResponseBody
  - `id` integer: The ID of the created contact.

## Other responses

- `403`: Your API key does not have permission to perform this action.
- `422`: An invalid parameter was supplied or a mandatory parameter was missing
- `429`: Too many requests have been made to this endpoint.
- `500`: An internal system error occurred

## Changes

- **2026-11-07** `d044bf6dc61e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/changes/vendor/contact/add/post.md)

---

[API](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api.md) - [All operations](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/revisions/d044bf6dc61e?raw)