---
title: "POST /v2/sar/connections"
method: POST
path: "/v2/sar/connections"
tags: ["Seller connections"]
---

# POST /v2/sar/connections

`POST /v2/sar/connections`

## Request

- Base URL: `https://api.peer.xyz`
- URL: `https://api.peer.xyz/v2/sar/connections`
- Auth: HTTP bearer

Create a wallet-owned App Clip handoff using a Privy JWT. Environment is selected by Curator.

## Request body

- union
  - object
    - `callerAddress` string, required
    - `returnUrl` string, uri, required
    - `state` string, required
    - `expectedPayeeIdHash` string
    - `platform` 'cashapp', required
    - `payeeHandle` string, required
    - `currencies` string[], required
  - object
    - `callerAddress` string, required
    - `returnUrl` string, uri, required
    - `state` string, required
    - `expectedPayeeIdHash` string
    - `platform` 'paypal', required
    - `payeeHandle` string, required
    - `paypalEmail` string, email, required
    - `identityActionType` 'register_paypal' | 'register_business_paypal'
    - `currencies` string[], required
  - object
    - `callerAddress` string, required
    - `returnUrl` string, uri, required
    - `state` string, required
    - `expectedPayeeIdHash` string
    - `platform` 'upi', required
    - `payeeHandle` string, required
    - `currencies` string[], required

## Response `201`

Connection link created

- object
  - `success` boolean, required
  - `message` string, required
  - `responseObject` object
    - `requestId` string, required
    - `expiresAt` string, required
    - `url` string, uri, required
  - `statusCode` number, required
  - `errorCode` string

## Changes

- **2026-10-25** `c819cb729540`: 1 breaking, 8 warning, 1 info
  - the request's body type changed from `object` to no type
  - removed the request property `callerAddress`
  - removed the request property `currencies`
  - removed the request property `expectedPayeeIdHash`
  - …6 more
- **2026-09-25** `dca2b5622809`: 1 breaking, 2 info
  - added the new required request property `payeeHandle`
  - added the new optional request property `paypalEmail`
  - added the required property `responseObject/url` to the response with the `201` status
- **2026-09-24** `5cdf2a34508f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/peer/apis/swagger-api/changes/v2/sar/connections/post.md)

---

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