API Templates
Save, sync, and identify templates used by the PDF API
The API can render custom templates saved from the Label Designer. A template defines one label or card: its physical dimensions, elements, bindings, colors, and background. Paper and sheet arrangement are selected separately with the request's layout object. System templates must first be saved as a custom copy.
Save and sync
- Sign in to the same account that owns the API key.
- Open the Label Designer and select or create a template.
- Confirm the dimensions of the individual label or card.
- Choose Save Template.
- Confirm that the Cloud synced message appears.
- Copy the Template ID from the success message or from the template card in My Templates.
Custom Template IDs start with custom-. The API key can access only templates owned by the same account.
Find a Template ID later
Open API Key Settings and find API Templates below the API key list. This table shows only custom templates that are available to the API. Select the copy icon beside a Template ID to copy it.
Select a template name or the edit icon to open that exact template in the Label Designer. If the template is not already stored in the current browser, the designer downloads your account's cloud copy and adds it to My Templates so you can preview or edit it.
The Label Designer also shows the ID beneath each card in My Templates. A template saved only in the browser is not API-ready until cloud sync succeeds. If an ID does not appear in API Templates, open that template while signed in and save it again.
Saving the same custom template again updates its cloud copy. Changing layout in an API request affects only that PDF and does not modify the cloud template.
Discover templates from an integration
List the API-ready templates owned by the API key account:
GET https://sheetstolabels.com/api/v1/templates
Authorization: Bearer <api_key>Each item includes its dimensions, variable names, compatible Print Layout preset IDs, and last update time. Inspect one template and receive complete compatible preset metadata with:
GET https://sheetstolabels.com/api/v1/templates/custom-1234567890
Authorization: Bearer <api_key>These endpoints return connector-safe metadata, not the complete visual template JSON. They do not consume Credits, but they require Trial or Business API access and count toward the API Key's per-minute request limit.
List all supported Avery and APLI-compatible sheet layouts with:
GET https://sheetstolabels.com/api/v1/layout-presets
Authorization: Bearer <api_key>Use search, widthMm, and heightMm query parameters to narrow the result. Prefer the compatiblePresets returned for a specific template when building a preset selector.
Delete an API template
In API Key Settings, select the delete icon beside a template and confirm Delete from cloud. This removes the cloud copy from your account, so its Template ID can no longer be used by the Business API. A copy stored in the current browser is not removed; delete that separately from My Templates if you no longer need it.
Clearing browser storage has the opposite scope: it removes local templates and PDF history, but it does not delete an already synced cloud template.
Privacy and cloud storage
SheetsToLabels is local-first for interactive document workflows. Spreadsheet rows, generated PDF files, and PDF history stay in your browser and are not uploaded as part of template sync.
Business API templates are the exception: when you are signed in and save a custom template, its layout and content are uploaded to your account's cloud storage so server-side API requests can render it. Only API keys owned by the same account can access that template.