The following table lists the documentation updates:
Date
Ticket Number
Change
8/5/2025
API-606
🚧 Coming soon Added new query parameters to filter or search orders by deliveryStatus, deliveryMethod, and recipientMobileNumber. See Get line items.
7/28/2025
API-663
🚧 Coming soon Enhanced the line items resend: POST {URI}/lineItems/{referenceLineItemId}/resendsto include the reason code as the body parameter when resending a reward. See Resend a line item.
7/23/2025
API-700
🚧 Coming soon Added externalRefID to the RewardStatus event payload to match the event with your original request and improve tracking across your systems. See Reward status payload.
7/14/2025
API_659
🚧 Coming soon Added the ability to update the low balance alerts via PATCH /customers/{customerIdentifier}/accounts/{accountIdentifier}/lowbalance/{balanceAlertID}. This helps improve the management of low balance alerts through the API. See how you can Update a low balance alert for a customer account.
7/11/2025
API-690
🐞 The response from tc-web-hooks was updated to include the expiresAt field as expected.
7/10/2025
API-627
🚧 Coming soon Added validation of delivery methods based on the attributes associated with a UTID. For example: UTID=U1234 has the attributes= (NONE, EMAIL, PHONE, and EMBEDDED). When the user resends the reward with deliveryMethod=PHONE, the system will allow the resend because PHONE is an eligible method for this UTID. When the user resends the reward with deliveryMethod=ADDRESS, the system will reject the resend because ADDRESS is not among the UTID's eligible delivery method.
7/8/2025
? RL-3938
🆕 Added customUrl as a URL reward type in credential types. customeUrl is a personalized or branded link that takes the user to a reward landing page. See Get credential types.
7/7/2025
API-660
🚧 Coming soon Added the ability to retrieve a list of low balance alerts for a customer account by calling GET /customers/{customerIdentifier}/accounts/{accountIdentifier}/lowbalance endpoint. This enhancement improves the monitoring and management of account balances through the API. See Get a list of all low balance alerts.
7/7/2025
API-539
🆕 Introduced the APICredentials webhook event under PLATFORM category to notify users when the API credentials are created, viewed, updated, or deleted. This improves the security and real-time monitoring of API. See Platform category events.
🚧 Coming soon Enhanced the order processing logic: previously, the system determined if an order was for physical delivery based on the presence of a recipient address. The new logic requires the API to use the deliveryMethod field instead. See POST orders for when you create an order.
6/27/2025
API-651
🆕 Enhanced the "campaign" field to accept any character (including special characters), similar to the NOTES and MESSAGE fields. The field length is set to 1024 characters. See Orders and Line Items.
🚧 Coming soon Created the ability to delete a specific low balance alert via the API by using DELETE {URI}/customers/{customerIdentifier}/accounts/{accountIdentifier}/lowbalance/{balanceAlertID}. See Delete a low balance alert for a customer account.
6/9/2025
API-654
Created the ability to set a low balance alert
5/14/2025
Added service account (username and password) as additional security level to OAuth connection. As of May 14, 2025, the Tango API will require client ID, client secret, service account username, and service account password to generate the access token when using OAuth. See Use OAuth for more secure connection.
5/7/2025
API-328
Added Transaction eventType to the Account category in supported webhooks. Webhook events are sent when funds are added, removed, or transferred to or from your Tango account. See about Transition.
5/7/2025
API-573
Added rewardType query parameter to GET {URI}/catalogs to enhance querying flexibility for users who access Tango catalog. See Get all items in the platform catalog.
5/7/2025
API-271
Added the new GET {URI}/webhooks/eventtypes endpoint to webhooks to list all event types offered in the system for subscription. See Get all subscription event types.
5/1/2025
API-437
Updated recipient's physical address fields to include new characters such as &, %, #, @ in the POST {URI}/orders. See Create an order under a specific account.
🚧 Coming soon Modified POST {URI}/orders/{referenceOrderID}/resends to allow for SMS delivery when resending a specific order by adding newDeliveryMethod and newMobile as body parameters. We will support different delivery methods including NONE, EMAIL, PHONE, and EMBEDDED. See Resend a specific order.
🚧 Coming soon Added SMS parameter to GET {URI}/orders payload to include deliveryMethod , recipientMobileNumber , and deliveryStatus in the payload. This change improves the flexibility and options for order delivery. See Get a list of orders placed on this platform.
5/7/2025
API-563
🚧 Coming soon Added SMS parameters to GET {URI}/lineItems payload to include deliveryMethod , recipientMobileNumber , and deliveryStatus in the payload. This change enhances the delivery options available to users and retrieves and filters the information about all line items ordered on the platform. See Get line items.
4/30/25
API-347
Added externalRefID to the POST {URI}/creditCardDeposits endpoint as an idempotent key support for funding cross reference and to prevent accidental funding duplication. See Fund an account .
4/30/25
API-389
Added a body parameter: externalRefID to POST {URI}/transferFunds endpoint for funding cross reference and to prevent accidental funding duplication. See Transfer funds .
4/17/2025
API-540
Added RewardStatus event type under Reward category in supported webhooks that sends notifications every time a reward status is changed. See Reward status.
(Closed Release) Improved OAuth 2.0 for more secure connection. You need four pieces of information to acquire a token: the client ID, client secret, service account username, and service account password. See Secure your connection with Tango API.
We now accept Australian dollars (AUD) for Global Choice Link. To create an AUD account, see POST {URI}/customers/{customerIdentifier}/accounts. Other accepted currencies are CAD, EUR, GBP, or USD.
🆕 Included error responses for Fund endpoints. See Manage funds endpoints.
2/18/2025
API-506
Added a list of reasons for freeze, unfreeze, cancel, and reissue line items. Use GET {URI}/lineItems/reasonCodes to get the reason codes. See Get all reason codes.
2/18/2025
API-214
Added pagination to the list of customers when you use GET {URI}/customers. with this query parameter, you can receive a paginated payload helping you manage the results more effectively. See Get a list of all customers .
2/18/2025
API-218
Added pagination to the list of credit cards when you use GET {URI}/creditCards. with this query parameter, you can receive a paginated payload helping you manage the results more effectively. See List all credit cards registered on this platform.
2/18/2025
API-451
Added the ability to update line item parameters (purchase order number, campaign, and order notes) using PATCH /lineItems/ {referenceLineItemID}.
2/18/2025
API-213
Added query parameters to GET {URI}/customers. Filter by items such as display name, status, account number, and more. See Get a list of all customers .
2/18/2025
API-462
API-463
API-464
API-508
Added capabilities to freeze, unfreeze, cancel, and reissue line items:
-To cancel, callPOST /lineItems/{referenceLineItemID}/cancel.
-To freeze, call POST /lineItems/{referenceLineItemID}/freeze.
-To unfreeze, call POST /lineItems/{referenceLineItemID}/unfreeze.
-To reissue, call POST /lineItems/{referenceLineItemID}/reissue.
12/3/2024
API-422
IncludedrewardStatus in the payload of GET {URI}/lineItems to indicates whether a reward is frozen or active.
Updated OAuth 2.0 with a note: "When you deactivate a client credential, all active tokens for this client will become invalid and your integration will be broken. Deactivation cannot be reversed." OAuth 2.0 is currently on a limited release.
9/30/2024
Added account statuses such as Active, Inactive, etc. to the webhook event: AccountStatus.
8/15/2024
Deprecated credentials and added a note to use credentialList instead.
4/8/2024
API-373
Added a new endpoint to filter your catalog for your recipients based on country and currency. Use the GET /rewardCountries endpoint to determine the preferred currency.
3/25/2024
Added a new parameter to use with POST {URI}/orders/{referenceOrderID}/resends for when you are resending an order.
3/15/2024
API-211
Improved the results of GET {URI}/accounts by adding more query parameters.
2/20/2024
API-241
Added ability to categorize each brand into industry-standard categories within the Tango catalog and group/filter the brand in your custom catalog display. See categoryIds.
2/13/2024
API-334
Added fundingNotification body parameter to POST {URI}/customers/{customerIdentifier}/accounts endpoint to be able to add 1 to 5 email addresses to your account when crating an account. See Create an account under a specific customer.
Added fundingNotification body parameter to PATCH {URI}/customers/{customerIdentifier}/accounts/{accountIdentifier} endpoint to be able to add 1 to 5 email addresses to your account when updating an account. See Update an account under a specific customer.
2/8/2024
API-345
Improved the results of GET {URI}/creditCards by adding optional query parameters under funding account.
2/8/2024
API-338
Added currency type. Use the currencyCode body parameter with POST {URI}/customers/{customerIdentifier}/accounts to be able to create an account for a specific customer in any of these supported currencies: CAD, EUR, GBP, and USD. See Create an account under a specific customer.
1/29/2024
API-240
Added the ability to transfer funds from one account to another account of the same currency using GET {URI}/transferFunds.
2023
10/23/2023
API-269
Added GET /webhooks/{webhookId}/events?fromRevision={fromRevision}&toRevision={toRevision}&maxResultsint32={maxResultsint32} to receive all past event notifications up to three months.
This feature is available in limited release, contact your Customer Success Manager (CSM) or [email protected] for more information.
10/17/2023
API-270
Added POST /webhooks/{webhookId}/replay?fromRevision={fromRevision}&toRevision={toRevision} to redeliver past webhook event notifications up to Three months. Notifications older than three months are not retrievable.
This feature is available in limited release, contact your Customer Success Manager (CSM) or [email protected] for more information.
10/12/2023
API-293
Added GET {URI}/choiceProducts/{choiceProductUtid}/catalog to get the content of a Tango Choice catalog. You must have access to the Catalog to see the content.
Added the ability to set a specific expiration date, such as 12/31/24, for a Promo Link at the time of order with Tango API instead of setting the expiration date as x days from the time of issuance. See the Promo Link acceptance criteria .
10/7/2023
API-306
Categories have a Universal Unique Identifier (UUID). You can filter a catalog by category using GET {URI}//brandCategories.
Added the ability to modify the recipient address object to be included in all returning payloads of line items, as well as in any query parameters that can filter and search the recipient information.
9/27/2023
API-304
Added ptid to GET {URI}/ordersso you can get the list of Printed Reward Link orders.
9/26/2023
API-303
Added ptid to POST {URI}/orders so you can create Printed Reward Link orders.
