---
title: "Bulk connect link for Apple"
method: POST
path: "/connected-accounts/connect-apple/bulk"
tags: ["Connected Accounts"]
---

# Bulk connect link for Apple

`POST /connected-accounts/connect-apple/bulk`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/connected-accounts/connect-apple/bulk`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/connected-accounts/connect-apple/bulk/post.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Headers

- `Synup-Version` string, required
- `Authorization` string, required

## Request body

- AppleOauthBulkRequestV2
  - `input` object, required
    - `successUrl` string, required: Redirect URL on successful authorization.
    - `errorUrl` string, required: Redirect URL on failed authorization.
    - `platform` string: `local` (default) or `social`.
    - `entityId` string: Brand ID when platform is `social`.
    - `onboarding` boolean
    - `clientMutationId` string

## Response `200`

Successful response

- object
  - `data` object
    - `bulkConnectLinkForApple` AppleOauthBulkPayloadV2
      - `success` boolean
      - `url` string: OAuth link to redirect the user to (1-day TTL).
      - `errors` MutationErrorV2[]
        - `code` string
        - `message` string
        - `contextInfo` object[]
      - `clientMutationId` string

## Other responses

- `401`: Unauthorized - Invalid or missing API key

---

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