Our API is currently in open beta, if you encounter any issues or have a suggestion, please email us at devs@lumaprints.com. Your insights are invaluable to us.

Subscribe to a new event

Sandbox

https://us.api-sandbox.lumaprints.com

POST

/api/v1/webhook

When setting up a new webhook subscription, our system will verify the provided URL, along with the optional username and password. If the verification fails, the subscription will be rejected. For the verification to succeed, your endpoint must respond with a status code of 200.

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Body Params application/json

Example

{
    "event": "shipping",
    "storeId": "1088",
    "url": "https://www.example.com/webhook",
    "username": "Lumaprints",
    "password": "Password123"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://us.api-sandbox.lumaprints.com/api/v1/webhook' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
    "event": "shipping",
    "storeId": "1088",
    "url": "https://www.example.com/webhook",
    "username": "Lumaprints",
    "password": "Password123"
}'

Responses

🟢201Created

application/json

Body

Examples

SuccessSuccessSuccess

{
    "status": 201,
    "message": "Webhook has been successfully created."
}

🟠400Duplicate Webhook URL

🟠400URL Not accessible

Modified at 2024-08-29 23:29:17

Shipping cost