# The customer dealt with a connected business

`POST /platform-customers/{id}/link` · Rivier · contacts

The customer dealt with a connected business: their contact in that business's own project is found or made (only where the business granted contacts) and the link kept. The business sees its own contact and nothing of the platform's other businesses.

- Scope: contacts:write
- Graphql: Mutation.contactsPlatformCustomerLink
- Sdk: contacts.platformCustomer.link
- Cli: contacts platform customer link

## Parameters

- `id` (path, required), string

## Request body

`application/json`

```json
{
  "type": "object",
  "properties": {
    "connectionId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "connectionId"
  ],
  "additionalProperties": false
}
```

## Responses

- `200`: Success
- `400`: The request was malformed
- `401`: No valid credential
- `403`: The credential lacks the scope, origin or address
- `429`: Over the key's rate limit; see Retry-After

## Example

```sh
curl -X POST 'https://api.rivier.ai/platform-customers/{id}/link' \
  -H 'Authorization: Bearer $KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "connectionId": "string"
}'
```