---
title: Create a merchant id
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/post-v1-merchantids
---

# Create a merchant id

Add a new merchant ID to your team.

## URL

POST https://api.appstoreconnect.apple.com/v1/merchantIds

## Response Codes

201 Created: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 409 Conflict: 422 : 429 :

## Mentioned in

Managing merchant IDs and Payment Processing certificates

## See Also

### Managing merchant IDs

- [Managing merchant IDs and Payment Processing certificates](appstoreconnectapi/managing-payment-processing-certificates.md)
- [List merchant ids](appstoreconnectapi/get-v1-merchantids.md)
- [Read details for a merchant id](appstoreconnectapi/get-v1-merchantids-_id_.md)
- [List certificates for a merchant id](appstoreconnectapi/get-v1-merchantids-_id_-certificates.md)
- [List certificate IDs for a merchant ID](appstoreconnectapi/get-v1-merchantids-_id_-relationships-certificates.md)
- [Modify merchant ids](appstoreconnectapi/patch-v1-merchantids-_id_.md)
- [Delete a merchant id](appstoreconnectapi/delete-v1-merchantids-_id_.md)