Shed Suite Support Desk

? Full API Documentation: https://app.shedsuite.com/api/docs/index.html#/

Overview

The Shed Suite Public API lets you programmatically access your Shed Suite data, including contacts, customer orders, and inventory. All API requests go through:

https://app.shedsuite.com/api/public

Step 1: Get Your API Token

Before you can use any endpoint, you need to create an API token. This is a one-time setup step.

What You'll Need

• Your Shed Suite username (email) and password
• A tool to make HTTP requests (we'll show examples using cURL and Claude Code)

Create a Token (cURL)

curl -X POST https://app.shedsuite.com/api/public/tokens/v1 \
  -u "your-email@example.com:your-password" \
  -H "Content-Type: application/json" \
  -d '{
    "tokenName": "My Integration Token",
    "expiresAt": "2027-01-01T00:00:00.000Z",
    "scopes": ["api:read", "api:write"]
  }'

What each field means:

Create a Token (Claude Code)

In Claude Code, you can ask Claude to create your API token by providing the cURL command above. Claude will run it and return your token. Alternatively, paste the cURL command directly into your terminal from within Claude Code.

Save Your Token

The response will include your API token string. Copy and save it somewhere secure — you'll use it for every future API request.

Step 2: Use Your Token in Requests

For all subsequent API calls, include your token in the Authorization header as a Bearer token:

Authorization: Bearer YOUR_TOKEN_HERE

Example: Fetch Your Contacts

curl -X GET "https://app.shedsuite.com/api/public/contacts/v1?limit=10&offset=0" \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"

In Claude Code, include the Authorization header in your cURL commands or ask Claude to make the request for you.

Available Endpoints

Tokens (Authentication)

Contacts

Customer Orders

Sorting options for orders: dateOrdered, dateDelivered, dateCancelled, dateFinished, dateProcessed, dateScheduledForDelivery

Date filtering: Use dateField, dateFrom, and dateTo together. Dates can be YYYY-MM-DD or relative expressions like now-30d (last 30 days) or now/M (start of current month).

Inventory

Sorting options for inventory: date_finish, date_removed, date_ordered, date_delivered

Common Examples

Get orders from the last 30 days

curl -X GET "https://app.shedsuite.com/api/public/customer-orders/v1?dateField=dateOrdered&dateFrom=now-30d&dateTo=now&limit=100" \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"

Get all active inventory (excluding deleted)

curl -X GET "https://app.shedsuite.com/api/public/inventory/v1?hideDeleted=true&limit=100&offset=0" \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"

Create a new contact

curl -X POST https://app.shedsuite.com/api/public/contacts/v1 \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Jane",
    "lastName": "Smith",
    "email": "jane@example.com",
    "phone": "555-123-4567",
    "zipCode": "30301"
  }'

Paginate through large result sets

Results are limited to 100 items per request. Use offset to page through:

# Page 1
curl "https://app.shedsuite.com/api/public/contacts/v1?limit=100&offset=0" \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"

# Page 2
curl "https://app.shedsuite.com/api/public/contacts/v1?limit=100&offset=100" \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"

Troubleshooting

Managing Your Tokens

• List tokens: GET /tokens/v1 — see all active tokens for your company.
• Revoke a token: DELETE /tokens/v1/{tokenId} — immediately disables that token. Use this if a token is compromised or no longer needed.

Quick Reference