List your saved templates
const url = 'https://api.1up.gift/templates?offset=0&limit=100';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.1up.gift/templates?offset=0&limit=100' \ --header 'Authorization: Bearer <token>'A template is a saved send preset — gift, value, country, greeting and expiry — created in 1UP.
Send one with POST /send/template. Newest first.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”How many templates to skip. Defaults to 0.
Templates per page, 1–200. Defaults to 100.
Responses
Section titled “Responses”The matching page of templates.
A saved send preset: the gift, value, country, greeting and expiry to use, created in 1UP and sent with
POST /send/template.
object
The template id.
The template name, as shown in 1UP.
How the template picks the gift: a single product or a collection the recipient chooses from.
The product this template sends, when it sends a single gift.
The collection this template sends, when the recipient chooses.
The name of that product or collection as it stood when the template was saved, so a caller can label the template without a second lookup.
The per-recipient face value the template sends at.
The ISO code of the currency Value is denominated in, so a caller can render the budget. Null for a template whose gift has since been deleted, leaving nothing to say what its value was priced in.
The ISO 3166-1 alpha-2 country the template sends for.
The gift wrapping the template uses, unless you override it.
Who the gift is from, unless you override it.
The personal message, unless you override it.
Days after claiming that gifts from this template expire, or null for the default policy.
When the template was created, in UTC.
A saved send preset: the gift, value, country, greeting and expiry to use, created in 1UP and sent with
POST /send/template.
object
The template id.
The template name, as shown in 1UP.
How the template picks the gift: a single product or a collection the recipient chooses from.
The product this template sends, when it sends a single gift.
The collection this template sends, when the recipient chooses.
The name of that product or collection as it stood when the template was saved, so a caller can label the template without a second lookup.
The per-recipient face value the template sends at.
The ISO code of the currency Value is denominated in, so a caller can render the budget. Null for a template whose gift has since been deleted, leaving nothing to say what its value was priced in.
The ISO 3166-1 alpha-2 country the template sends for.
The gift wrapping the template uses, unless you override it.
Who the gift is from, unless you override it.
The personal message, unless you override it.
Days after claiming that gifts from this template expire, or null for the default policy.
When the template was created, in UTC.
Examplegenerated
[ { "id": 1, "name": "example", "giftSelectionType": "example", "giftProductId": 1, "giftsCollectionId": 1, "giftName": "example", "value": 1, "currency": "example", "country": "example", "wrappingKey": "example", "fromName": "example", "message": "example", "expiryAfterDays": 1, "creationDate": "2026-04-15T12:00:00Z" }]A saved send preset: the gift, value, country, greeting and expiry to use, created in 1UP and sent with
POST /send/template.
object
The template id.
The template name, as shown in 1UP.
How the template picks the gift: a single product or a collection the recipient chooses from.
The product this template sends, when it sends a single gift.
The collection this template sends, when the recipient chooses.
The name of that product or collection as it stood when the template was saved, so a caller can label the template without a second lookup.
The per-recipient face value the template sends at.
The ISO code of the currency Value is denominated in, so a caller can render the budget. Null for a template whose gift has since been deleted, leaving nothing to say what its value was priced in.
The ISO 3166-1 alpha-2 country the template sends for.
The gift wrapping the template uses, unless you override it.
Who the gift is from, unless you override it.
The personal message, unless you override it.
Days after claiming that gifts from this template expire, or null for the default policy.
When the template was created, in UTC.
Examplegenerated
[ { "id": 1, "name": "example", "giftSelectionType": "example", "giftProductId": 1, "giftsCollectionId": 1, "giftName": "example", "value": 1, "currency": "example", "country": "example", "wrappingKey": "example", "fromName": "example", "message": "example", "expiryAfterDays": 1, "creationDate": "2026-04-15T12:00:00Z" }]