Create a new customer

post

https://example.com/peppol-api/customers

To send PEPPOL invoices/documents, new customers must be registered first using this POST /customers endpoint.
This endpoint requires certain details about the customer to be provided, including their company name, contact info, and other relevant information.
Once the registration is successful, a response is returned containing the unique identifier for the newly registered customer. This identifier must be used in the X-Customer header when sending invoices later on.

Only registered customers are authorized to send Peppol invoices/documents, and any attempts to do so without proper registration may result in errors or rejection.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

Language

Credentials

OAuth2

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/sh.peppol.api.v001+json

201The customer was successfully created and a response with a unique identifier for the customer was returned. This identifier must be used in the X-Customer header when sending invoices via the POST /invoices endpoint.

400Bad Request, The syntax of the request entity is incorrect the service was unable to process the request. Action: the message needs to be fixed and retried by the sender.

401Unauthorized, The request has not been applied because it lacks valid authentication credentials for the target resource. Action: Add Authorization information to the http-request.

403Forbidden, If authentication credentials were provided in the request, the server considers them insufficient to grant access.

404Not Found, the specified identifier of the resource was not found.

406The service was unable to process your request due to an unsupported accept header. Please ensure that your accept header is set correctly and try again.

415The service was unable to process your request due to an unsupported content type header. Please ensure that your content type header is set correctly and try again.

500Internal Server Error, The service was unable to process the request. Action: Please contact our support for this issue including all details(Request-body, error message, ..).

503Maintenance mode, the server is currently unable to handle the request due to a temporary maintenance of the API. Action: Please try again at a later moment.