GoCardless Embed

Creating a creditor

In this step of the GoCardless Embed guide you will create a creditor to represent one of your merchants.

By having a creditor for each merchant you will be able to pay out separately for each creditor, customise the beneficiary name the payer sees, and perform reconciliation on a per-merchant basis.

POST /creditors

You can create a creditor by performing a POST request to the /creditors endpoint. The required parameters are:




The trading name of the creditor.


The type of business of the creditor. One of: individual, company, charity, partnership, and trust.


The country that the creditor is registered in, as a ISO 3166-1 alpha-2 code.

Examples of how to make this request using the GoCardless client libraries:

POST https://api.gocardless.com/creditors HTTP/1.1 Content-Type: application/json { "creditors": { "name": "Example Ltd", "country_code": "GB", "creditor_type": "company" } } HTTP/1.1 201 Created Location: /creditors/CR123 Content-Type: application/json { "creditors": { "id": "CR123", "created_at": "2017-02-16T12:34:56.000Z", "name": "Example Ltd", "creditor_type": "company", "country_code": "GB", ... } }

The API will respond with a creditor object containing a creditor ID starting with 'CR'. This ID will be used in subsequent steps.

For more details, see the API reference docs for this endpoint.

What's next?

Adding a creditor bank account