Skip to main content
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

const username = "your_username";
const password = "your_password";

// Basic Auth: base64 encode "username:password"
const credentials = btoa(`${username}:${password}`);

fetch("https://api.fourthwall.com/open-api/v1.0/shops/current", {
  headers: {
    "Authorization": `Basic ${credentials}`
  }
})
  .then(res => res.json())
  .then(data => console.log(data));

import requests
from requests.auth import HTTPBasicAuth

# Basic Auth is built into the requests library
response = requests.get(
    "https://api.fourthwall.com/open-api/v1.0/shops/current",
    auth=HTTPBasicAuth("your_username", "your_password")
)
print(response.json())
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