Purpl
Documentation menu
Purpl Documentation
Get started
SDK
Purpl service
Server API
API Reference
POST/v1/customers/google-play/link

Link a Google Play customer to an application account

Links a verified Google Play purchase to an application account. This endpoint requires an application API credential with customers:write.

Authentication: BearerRequired scope: customers:write

Request body

packageNameRequired
string

The Android package name registered in Purpl.

purchaseTokenRequired
string

The purchase token returned by Google Play.

productKindRequired
subscription | one_time_product

The Google Play product kind.

productIdentifierOptional
string | null

The optional product identifier used to narrow one-time purchase lookup.

applicationAccountIdentifierRequired
string

A stable account identifier from the application.

Responses

200The linked customer's current entitlements.
customerIdentifierRequired
string | null · uuid
applicationIdentifierRequired
string · uuid
entitlementsRequired
CustomerEntitlement[]
400The request body, parameter, or verified store payload is invalid.
errorRequired
string

A stable machine-readable error code.

401The application API credential is missing or invalid.
errorRequired
string

A stable machine-readable error code.

403The application API credential does not include the required scope.
errorRequired
string

A stable machine-readable error code.

404The application, store configuration, customer, or paywall was not found.
errorRequired
string

A stable machine-readable error code.

409The customer identity conflicts with an existing verified identity.
errorRequired
string

A stable machine-readable error code.

Request example

cURL
curl 'https://api.purpl.sh/v1/customers/google-play/link' \
  --header 'Authorization: Bearer <application-api-credential>' \
  --header 'Content-Type: application/json' \
  --data '{
    "packageName": "com.example.app",
    "purchaseToken": "<purchase-token>",
    "productKind": "subscription",
    "productIdentifier": "plus.monthly",
    "applicationAccountIdentifier": "user-123"
  }'