Skip to main content
POST
Extend buyer access
Adds days to a pass: the new end date is the later of now and the current end date, plus days. Lifetime access cannot be extended, and neither can a revoked record (grant it again instead); both return 400. Send the same grantId on a retry to make it a no-op. Requires the WRITE_INVENTORY scope.
These endpoints only work on a store whose type is digital. On any other store they return 403 with This is only available on digital stores. See Digital stores.

Authorizations

Authorization
string
header
required

Installed-app access token (prefix app_), issued by the OAuth install flow. The store is bound to the token server-side , never send a shop id.

Path Parameters

id
string
required

The access record's ObjectId.

Body

application/json
days
integer
required

Days to add.

Required range: 1 <= x <= 3650
grantId
string

Optional ObjectId you generate. Makes a retried request a no-op.

Response

Extend buyer access: success.

status
integer
required
Example:

200

success
boolean
required
Example:

true

message
string
required
Example:

"Access extended"

data
object
required

One buyer's access record. There is one record per buyer, product (or the all-access pass) and kind, so buying a pass again extends the same record.

Example: