curl --request POST \
--url https://apiv3.usecorvex.com.br/api/v1/gifts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Store-Id: <x-store-id>' \
--data '
{
"productId": "22222222-2222-4222-8222-222222222222",
"name": "Squeeze acima de R$ 150",
"description": null,
"active": true,
"minCartQuantity": null,
"maxCartQuantity": null,
"minCartTotal": 150,
"maxCartTotal": null,
"priority": 0,
"startsAt": null,
"endsAt": null,
"triggerProductIds": []
}
'const options = {
method: 'POST',
headers: {
'X-Store-Id': '<x-store-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
productId: '22222222-2222-4222-8222-222222222222',
name: 'Squeeze acima de R$ 150',
description: null,
active: true,
minCartQuantity: null,
maxCartQuantity: null,
minCartTotal: 150,
maxCartTotal: null,
priority: 0,
startsAt: null,
endsAt: null,
triggerProductIds: []
})
};
fetch('https://apiv3.usecorvex.com.br/api/v1/gifts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://apiv3.usecorvex.com.br/api/v1/gifts"
payload = {
"productId": "22222222-2222-4222-8222-222222222222",
"name": "Squeeze acima de R$ 150",
"description": None,
"active": True,
"minCartQuantity": None,
"maxCartQuantity": None,
"minCartTotal": 150,
"maxCartTotal": None,
"priority": 0,
"startsAt": None,
"endsAt": None,
"triggerProductIds": []
}
headers = {
"X-Store-Id": "<x-store-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"success": true,
"data": {
"gift": {
"id": "77777777-7777-4777-8777-777777777777",
"storeId": "11111111-1111-4111-8111-111111111111",
"productId": "22222222-2222-4222-8222-222222222222",
"productName": "Squeeze",
"name": "Squeeze acima de R$ 150",
"description": null,
"active": true,
"minCartQuantity": null,
"maxCartQuantity": null,
"minCartTotal": 150,
"maxCartTotal": null,
"priority": 0,
"startsAt": null,
"endsAt": null,
"triggerProductIds": [],
"createdAt": "2026-09-24T14:00:00.000Z",
"updatedAt": "2026-09-24T14:00:00.000Z"
}
}
}{
"success": false,
"error": {
"message": "X-Store-Id deve ser um UUID válido",
"code": "VALIDATION_ERROR"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 400
}
}{
"success": false,
"error": {
"message": "Esta rota exige uma API Key. Use Authorization: Bearer cvx_live_...",
"code": "AUTH_API_KEY_REQUIRED"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 401
}
}{
"success": false,
"error": {
"message": "Sua API Key não tem o escopo necessário para esta operação.",
"code": "AUTH_SCOPE_DENIED"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 403
}
}{
"success": false,
"message": "Muitas requisições. Tente novamente em instantes.",
"error": "RATE_LIMITED",
"retryAfter": 12
}Criar brinde
O productId é o produto ganho como brinde.
minCartQuantity / maxCartQuantity filtram pela quantidade de itens no carrinho. minCartTotal / maxCartTotal filtram pelo valor.
Esses campos de quantidade do carrinho não existem em order bumps. Lá, maxQuantity limita unidades do item oferecido no bump.
curl --request POST \
--url https://apiv3.usecorvex.com.br/api/v1/gifts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Store-Id: <x-store-id>' \
--data '
{
"productId": "22222222-2222-4222-8222-222222222222",
"name": "Squeeze acima de R$ 150",
"description": null,
"active": true,
"minCartQuantity": null,
"maxCartQuantity": null,
"minCartTotal": 150,
"maxCartTotal": null,
"priority": 0,
"startsAt": null,
"endsAt": null,
"triggerProductIds": []
}
'const options = {
method: 'POST',
headers: {
'X-Store-Id': '<x-store-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
productId: '22222222-2222-4222-8222-222222222222',
name: 'Squeeze acima de R$ 150',
description: null,
active: true,
minCartQuantity: null,
maxCartQuantity: null,
minCartTotal: 150,
maxCartTotal: null,
priority: 0,
startsAt: null,
endsAt: null,
triggerProductIds: []
})
};
fetch('https://apiv3.usecorvex.com.br/api/v1/gifts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://apiv3.usecorvex.com.br/api/v1/gifts"
payload = {
"productId": "22222222-2222-4222-8222-222222222222",
"name": "Squeeze acima de R$ 150",
"description": None,
"active": True,
"minCartQuantity": None,
"maxCartQuantity": None,
"minCartTotal": 150,
"maxCartTotal": None,
"priority": 0,
"startsAt": None,
"endsAt": None,
"triggerProductIds": []
}
headers = {
"X-Store-Id": "<x-store-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"success": true,
"data": {
"gift": {
"id": "77777777-7777-4777-8777-777777777777",
"storeId": "11111111-1111-4111-8111-111111111111",
"productId": "22222222-2222-4222-8222-222222222222",
"productName": "Squeeze",
"name": "Squeeze acima de R$ 150",
"description": null,
"active": true,
"minCartQuantity": null,
"maxCartQuantity": null,
"minCartTotal": 150,
"maxCartTotal": null,
"priority": 0,
"startsAt": null,
"endsAt": null,
"triggerProductIds": [],
"createdAt": "2026-09-24T14:00:00.000Z",
"updatedAt": "2026-09-24T14:00:00.000Z"
}
}
}{
"success": false,
"error": {
"message": "X-Store-Id deve ser um UUID válido",
"code": "VALIDATION_ERROR"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 400
}
}{
"success": false,
"error": {
"message": "Esta rota exige uma API Key. Use Authorization: Bearer cvx_live_...",
"code": "AUTH_API_KEY_REQUIRED"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 401
}
}{
"success": false,
"error": {
"message": "Sua API Key não tem o escopo necessário para esta operação.",
"code": "AUTH_SCOPE_DENIED"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 403
}
}{
"success": false,
"message": "Muitas requisições. Tente novamente em instantes.",
"error": "RATE_LIMITED",
"retryAfter": 12
}Authorizations
API Key no formato cvx_live_..., criada no painel Corvex. Não use JWT de sessão nem x-api-key.
Headers
UUID da loja. A chave precisa ter esta loja autorizada.
Body
Produto que o cliente ganha como brinde.
3 - 200Quantidade mínima de itens no carrinho para liberar o brinde. null = sem mínimo. Este campo não existe em order bumps.
x >= 0Quantidade máxima de itens no carrinho para liberar o brinde. null = sem máximo. Este campo não existe em order bumps.
x >= 0Valor mínimo do carrinho (R$) para liberar o brinde. null = sem mínimo.
x >= 0Valor máximo do carrinho (R$) para liberar o brinde. null = sem máximo.
x >= 0x >= 0Início da vigência em ISO 8601. null = começa imediatamente.
Fim da vigência em ISO 8601. null = sem data de término.
Produtos no carrinho que liberam o brinde. Array vazio = qualquer produto.
Response
Criado.