---
title: Associate Seat
framework: App Store Server API
role: symbol
role_heading: Web Service Endpoint
platforms: [app store server api 1.23+]
path: appstoreserverapi/associate-seat
---

# Associate Seat

Associate a customer with a claimed seat in a group subscription that uses developer-hosted invitations.

## URL

POST https://api.storekit.apple.com/groups/v1/transactions/{originalTransactionId}/seats/{seatClaimId}/associate

## Sandbox URL

POST https://api.storekit-sandbox.apple.com/groups/v1/transactions/{originalTransactionId}/seats/{seatClaimId}/associate

## Path Parameters

originalTransactionId: The original transaction identifier of the group purchaser’s subscription. seatClaimId: The identifier of the seat claim, which the Claim Seat endpoint returns.

## Response Codes

200 OK: Request succeeded. 400 Bad Request: Invalid request. See the error code for more information. 401 Unauthorized: The JSON Web Token (JWT) in the authorization header is invalid. For more information, see Generating JSON Web Tokens for API requests. 403 Forbidden: The subscription isn’t active. 404 Not Found: The original transaction identifier, the app transaction identifier, or the seat claim identifier wasn’t found. 429 : The request exceeded the rate limit. 500 Internal Server Error: Server error. Try again later.

## Mentioned in

App Store Server API changelog

## Discussion

Discussion important: This endpoint is only available in the sandbox environment. Call this endpoint only for an active group subscription that uses developer-hosted invitations, where the invitationManagement value in the purchaser’s transaction is DEVELOPER. Use it to tell the App Store which customer occupies a seat that you already claimed, when you learn the customer’s appTransactionId after the claim. Provide the appTransactionId in an AssociateSeatRequest. If you know the customer’s appTransactionId when you claim the seat, include it in the ClaimSeatRequest instead; you don’t need to call this endpoint. Associating a customer with a seat doesn’t grant them access. You’re responsible for providing access to the subscription.

## HTTP Body

The request body that contains the app transaction identifier of the customer who occupies the seat.

## See Also

### Seat management

- [Get Seat Info](appstoreserverapi/get-seat-info.md)
- [GetSeatInfoResponse](appstoreserverapi/getseatinforesponse.md)
- [Claim Seat](appstoreserverapi/claim-seat.md)
- [ClaimSeatRequest](appstoreserverapi/claimseatrequest.md)
- [ClaimSeatResponse](appstoreserverapi/claimseatresponse.md)
- [Unclaim Seat](appstoreserverapi/unclaim-seat.md)
- [AssociateSeatRequest](appstoreserverapi/associateseatrequest.md)