The User Delete API provides a programmatic interface to permanently remove a user profile from Totango. NOTE: This refers to end-users of YOUR application, not Totango platform users. 

Use this API to automate data cleanup, or to comply with information removal requests from GDPR or equivalent privacy-frameworks.  

Important note, this delete action is IRREVERSIBLE! A deleted user information cannot be retrieved.

Your Authentication Keys

You will need your API key in order to access the API.

Login to Totango, click on your username (top-right corner of the page) and open your user profile. Your API Key is available under the INTEGRATION tab

General restrictions and API limits

Like all APIs, there is a global rate limit of 1,000 calls/minute for each token.

NOTE: This API should not be used to mass delete a large set of users. To do that, please contact support@totango.com with your request. 

Deleting a user

To delete a user, simply issue a DELETE request to the resource:

https://app.totango.com/api/v2/users/account-user/<ACCOUNT-ID>/<USER-ID>

where USER-ID is the user-ID on Totango and ACCOUNT-ID is the account the user is associated with. 

 curl -X DELETE --header 'app-token:YOUR-TOKEN-HERE' 'https://app.totango.com/api/v2/users/account-user/<ACCOUNT-ID>/<USER-ID>'

The API will return a 200 Success code  or 401 Unauthorized in case of invalid credentials. 

Note that it may take a few minutes for the delete to fully apply. 

FAQs 

Question: If the user is deleted from the account, does that user's activity stay associated to the account or is it lost?

Answer: Deleting a user means that it is no longer associated to any account and the account(s) will not contain a history of the user's previous activity. However, their activity will still be a part of historical usage aggregations and the number of activities from that user on the account(s) will remain.