# Bulk connect link for Apple

```http
POST https://api.synup.com/api/v4/connected-accounts/connect-apple/bulk
```

Generates an Apple Business Connect OAuth link that connects **multiple locations** in a single authorization flow. Unlike Connect link for Apple, no `locationId` is supplied — the set is account/platform-scoped. Redirect the user to the returned `url`; the link is valid for 1 day.

Use `platform` to target `local` (default) or `social`, and `entityId` to supply the brand ID when `platform` is `social`.

**Apple OAuth link variants:**
- **Connect link for Apple** — single location (`locationId`).
- **Bulk connect link for Apple** — multiple locations (this endpoint).
- **Renew connect link for Apple** — re-authorize an expired/revoked token.

Source: https://developer.synup.com/api/connected-accounts/bulk-connect-link-for-apple

## Header parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `Synup-Version` | string | required | API version date (YYYY-MM-DD). |

## Request body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `input` | object | required |  |
| `input.successUrl` | string | required | Redirect URL on successful authorization. |
| `input.errorUrl` | string | required | Redirect URL on failed authorization. |
| `input.platform` | string | optional | `local` (default) or `social`. |
| `input.entityId` | string | optional | Brand ID when platform is `social`. |
| `input.onboarding` | boolean | optional |  |
| `input.clientMutationId` | string | optional |  |

## Example request

```bash
curl -X POST 'https://api.synup.com/api/v4/connected-accounts/connect-apple/bulk' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "input": {
    "successUrl": "https://app.synup.com/apple/success",
    "errorUrl": "https://app.synup.com/apple/error",
    "platform": "local"
  }
}'
```

## Responses

| Status | Description |
| --- | --- |
| `200` | Successful response |
| `401` | Unauthorized - Invalid or missing API key |