# Creates payment method shares (bulk).

**POST /2026-2/payment-methods/{paymentMethodId}/shares**

Creates one share per user in the request. Maximum 50 users per request. Can be called multiple times to add more users; existing shares for the same user are updated.


## Servers
- PACE Payment Service: https://api.pace.cloud/payment (PACE Payment Service)


## Authentication methods
- Oauth2
- Oauth2


## Parameters

### Path parameters
- **paymentMethodId** (string(uuid))
  The ID of the payment method to share.


### Body: application/json (object)

- **expiresAt** (string(date-time))
  The date and time when all created shares expire. Omit for no expiration.
- **userIds** (array[string(uuid)])
  The IDs of the users to share the payment method with.


## Responses
### 201
The created payment method shares.

#### Body: application/json (object)
- **data** (array[object])
  A list of payment method shares.

### 401
Client authentication failed.

### 403
Missing one or more required scopes.

### 404
The payment method was not found.

### 500
An internal server error occurred.


[Powered by Bump.sh](https://bump.sh)