---
title: "Link a coach to a Bill.com vendor"
method: POST
path: "/api/admin/billcom/coaches/{coachUserId}/vendor"
tags: ["Bill.com Integration"]
---

# Link a coach to a Bill.com vendor

`POST /api/admin/billcom/coaches/{coachUserId}/vendor`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/api/admin/billcom/coaches/{coachUserId}/vendor`
- Auth: none declared

Maps a coach to a Bill.com vendor record for payment processing.

## Path parameters

- `coachUserId` string, uuid, required

## Request body

- object
  - `vendor_id` string, required: Bill.com vendor ID
  - `vendor_name` string, required: Vendor display name

## Response `200`

Vendor linked successfully

## Other responses

- `401`: Unauthorized
- `404`: Coach profile 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)
