Change history
The following table lists the documentation updates:
| Date | Change | Ticket Number |
|---|---|---|
| 5/7/2025 | Added Transaction eventType to the Account category in supported webhooks to be able to send webhook events when funds are added, removed, or transferred to or from your Tango account. See about Transition. | API-328 |
| 5/7/2025 | Added rewardType query parameter to GET {URI}/catalogs to retrieve item details for specific types of rewards. See Get all items in the platform catalog. | API-573 |
| 5/7/2025 | Added GET {URI}/webhooks/eventtypes to webhooks to retrieve a complete list of subscribable event types offered in the system. See Get all subscription event types. | API-271 |
| 5/7/2025 | Updated recipient fields to include new characters such as &, %, #, @ when using POST {URI}/orders. See Create an order under a specific account. | API-437 |
| 5/7/2025 | Added rewardType query parameter to GET {URI}/catalogs to search the catalog based on reward type such as. See Get all items in the platform catalog. | API-573 |
| 5/7/2025 | 🚧 Coming soon Added deliveryMethod , and newPhoneNumber to POST {URI}/orders/{referenceOrderID}/resends to resend a specific order using other delivery methods besides email including SMS, CARRIER, and EMBEDDED. See Resend a specific order. | API-564 |
| 5/7/2025 | 🚧 Coming soon Added deliveryMethod , and MobileNumber to POST {URI}/orders to deliver rewards to your recipients using other delivery methods besides email including SMS, CARRIER, and EMBEDDED. See Create an order under a specific account. | API-565 |
| 5/7/2025 | 🚧 Coming soon Added deliveryMethod , recipientMobileNumber , and deliveryStatus query parameters to GET {URI}/orders to filter and help track and manage orders based on their delivery method. See Get a list of orders placed on this platform. | API-562 |
| 5/7/2025 | 🚧 Coming soon Added deliveryMethod , recipientMobileNumber , and deliveryStatus to GET {URI}/lineItems to retrieve and filter the information about all line items ordered on the platform. See Get line items. | API-563 |
| 4/30/25 | 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 . | API-347 |
| 4/30/25 | Added a body parameter: externalRefID to POST {URI}/transferFunds endpoint for funding cross reference and to prevent accidental funding duplication. See Transfer funds . | API-389 |
| 4/17/2025 | Added RewardStatus event type under Reward category in supported webhooks that sends notifications every time a reward status is changed. See Reward status. | API-540 |
| 3/27/2025 | Emojis are not accepted for displayName or any text entry. See POST {URI}/customers in Create a new customer and POST {URI}/customers/{customerIdentifier}/accounts in Create an account under a specific customer. | API-363, API-549 |
| 3/26/2025 | Added the new terminology for product release. See Release terminology in our Glossary. | - |
| 3/26/2025 | (Closed Release) Added Line item delivery status for physical gift cards. | - |
| 3/21/2025 | (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. | - |
| 3/18/2025 | Added i18nkey codes and their error messages to provide more specific error codes. | API-542 |
| 3/3/2025 | 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. | API-519 |
| 2/18/2025 | 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. | API-506 |
| 2/18/2025 | 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 . | API-214 |
| 2/18/2025 | 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. | API-218 |
| 2/18/2025 | Added the ability to update line item parameters (purchase order number, campaign, and order notes) using PATCH /lineItems/ {referenceLineItemID}. | API-451 |
| 2/18/2025 | 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 . | API-213 |
| 2/18/2025 | Added capabilities to freeze, unfreeze, cancel, and reissue line items: -To cancel, call POST /lineItems/{referenceLineItemID}/cancel.-To freeze, call POST /lineItems/{referenceLineItemID}/freeze.-To unfreeze, call POST /lineItems/{referenceLineItemID}/unfreeze.-To reissue, call POST /lineItems/{referenceLineItemID}/reissue. | API-462 API-463 API-464 API-508 |
| 12/3/2024 | IncludedrewardStatus in the payload of GET {URI}/lineItems to indicates whether a reward is frozen or active. | API-422 |
| 12/3/2024 | IncludedisExpirable in the payload of GET {URI}/choiceProducts/{choiceProductUtid}/catalog and GET {URI}/catalogs to indicate whether or not the gift card has a expiry date. isExpirable is a boolean with true or false value. | API-224 |
| 10/16/2024 | 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 | 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. | API-373 |
| 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 | Improved the results of GET {URI}/accounts by adding more query parameters. | API-211 |
| 2/20/2024 | 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. | API-241 |
| 2/13/2024 | 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. | API-334 |
| 2/8/2024 | Improved the results of GET {URI}/creditCards by adding optional query parameters under funding account. | API-345 |
| 2/8/2024 | 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. | API-338 |
| 1/29/2024 | Added the ability to transfer funds from one account to another account of the same currency using GET {URI}/transferFunds. | API-240 |
| 2023 | ||
| 10/23/2023 | 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. | API-269 |
| 10/17/2023 | 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. | API-270 |
| 10/12/2023 | 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. | API-293 |
| 10/12/2023 | You can get all available Choice Products in your Tango catalog using GET {URI}/choiceProducts to returns utid. | API-294 |
| 10/12/2023 | Added GET {URI}/choiceProducts/{utid} to return the details for a specific Choice Product on your Tango platform. | API-313 |
| 10/11/2023 | 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 . | API-320 |
| 10/7/2023 | Categories have a Universal Unique Identifier (UUID). You can filter a catalog by category using GET {URI}//brandCategories. | API-306 |
| 10/5/2023 | Added the ability to order a Printed Reward Link using GET {URI}/lineItems when you Get a list of line items and GET {URI}/lineItems/{referenceLineItemID} when you Get details for a specific line item. | API-305 |
| 9/28/2023 | 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. | API-290 |
| 9/27/2023 | Added ptid to GET {URI}/ordersso you can get the list of Printed Reward Link orders. | API-304 |
| 9/26/2023 | Added ptid to POST {URI}/orders so you can create Printed Reward Link orders. | API-303 |
| 9/15/2023 | Added orderNotes GET {URI}/lineItems to see your order notes in both API and in the Tango portal line items history. | API-295 |
| 9/15/2023 | Added purchaseOrderNumber to order and line items. You are now able to include a PO Number when creating an order. | API-291 |
| 8/18/2023 | Added filters for one or more currencies when using the exchange rate endpoint. | API-282 |
| 6/16/2023 | Added OAuth authentication. | |
| 5/1/2023 | Added query parameters to "Get a list of Orders" and added pagination to "Get a list of Accounts". | |
| 2022 | ||
| 12/22/2022 | Exposed the GET /credentialtypes endpoint on the Test Console. | |
| 12/21/2022 | Added line items endpoints: - GET {URI}/lineItems to get a list of line items in the platform.- GET {URI}/lineItems/{referenceLineItemID}to get details for a specific line item.- POST {URI}/lineItems/{referenceLineItemId}/resends to resend a specific line item. | |
| 8/23/2021 | Added GET /catalogs endpoint filters for utid, brandKey, currencyCode and country. | |
| 1/14/2021 | Added API Reference to primary drop down. | |
| 7/15/2019 | Added Glossary to the API documentation. (work in progress) | |
| 11/29/2018 | Removed non-active cards from GET creditCards default response. Must use "?showInactive=true" to see inactive cards. | |
| 11/1/2018 | Added Managing Email Templates for new API endpoints. | |
| 8/6/2018 | Added note to clarify 4 digit security code require for Amex for test environment funding. | |
| 7/19/2018 | Added credentialType to improve reward credential parsing. | |
| 4/18/2018 | Added XSS and malicious behavior prevention note. | |
| 4/12/2018 | Added SSL cert examples. | |
| 4/6/2018 | Added email receipts information in Funding. | |
| 3/29/2018 | Returned ETID in the API order response. Without a custom template defined, Tango default template ID: E000000 is returned. | |
| 3/29/2018 | Included i18nKey in error responses which serves as a unique error code to facilitate international translations. | |
| 2/28/2018 | Added clarification regarding how "Pending funding" status works. Provided $5.55 and $6.55 test amounts in sandbox. | |
| 1/23/2018 | Updated: Group in Tango portal is calledCustomer in API. |
Updated 4 days ago