TruCustom API

Build powerful product customization experiences with our REST API and embeddable SDK.

Overview

The TruCustom API allows you to programmatically manage products, designs, templates, and assets. You can also embed our customization widget directly into your e-commerce platform.

Base URL

https://trucustom.net/api/v1

Key Features

• REST API - Full CRUD operations for all resources
• Embeddable Widget - Drop-in customization experience
• Webhooks - Real-time notifications for design events
• Multi-tenant - Manage multiple stores from one account

Authentication

All API requests require authentication via API key. Include your key in the Authorization header:

Authorization: Bearer tc_your_api_key_here

Get your API key from the Dashboard.

Response Format

All responses are returned in JSON format:

{
  "data": {
    "id": "uuid",
    "name": "Example",
    ...
  },
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 100,
    "total_pages": 5
  }
}

Rate Limits

API requests are rate limited to 1,000 requests per hour per API key. Rate limit headers are included in every response:

• X-RateLimit-Limit - Maximum requests per hour
• X-RateLimit-Remaining - Remaining requests
• X-RateLimit-Reset - Unix timestamp when limit resets