---
title: "Accept suggested vendors"
method: POST
path: "/vendors/candidates/accept"
tags: ["Vendors"]
---

# Accept suggested vendors

`POST /vendors/candidates/accept`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/vendors/candidates/accept`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Create vendor contacts from suggested-vendor keys (1-500 per call). Keys are normalized and verified against the current suggestion projection — forged keys are rejected as not_a_current_candidate and duplicates are skipped as already_exists. Requires the manage:contacts role. MCP vendor tools remain deferred to Phase 6/Gate 6.

## Request body

- object
  - `keys` string[], required

## Response `200`

Acceptance result: created count plus per-key skips

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)