Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.fourthwall.com/llms.txt

Use this file to discover all available pages before exploring further.

Get up and running with the Fourthwall API in three steps.

​
1. Get your API credentials

Creating API credentials requires the SUPER ADMIN role.
  1. Go to Settings > For Developers
  2. Under “Open API”, click Create API User
  3. Save the username and password that are generated

​
2. Make your first API call

Test your credentials by fetching your shop details. The Fourthwall API uses Basic Authentication - simply pass your username and password with each request. 
# Basic Auth - the simplest way to authenticate
curl -u "your_username:your_password" \
  https://api.fourthwall.com/open-api/v1.0/shops/current
The -u flag in cURL automatically handles Basic Auth encoding for you. Under the hood, it creates an Authorization: Basic <base64-encoded-credentials> header.
You should receive a response with your shop details: 
{
  "id": "sh_abc123",
  "name": "My Shop",
  "currency": "USD",
  ...
}

​
3. Explore the API

Now that you’re authenticated, explore what you can build:

List Orders

Fetch orders from your shop

List Products

Get your product catalog

Set up Webhooks

Get real-time event notifications

Full API Reference

Browse all available endpoints