API Guide







Create GDPR Request

In accordance with Article 15 of the GDPR, 250ok will aim to provide its customers with transparency and ease-of-access to their data. Through the GDPR Request Form, customers can access, export (or transfer), erase, or anonymize their personal data. Lastly, customers can restrict the processing of data subjects at any time by pausing data forwarding to 250ok. Data is returned in the following formats: XML, JSON, CSV and Serialized.

Required headers: X-API-KEY
Optional headers: ACCEPT (json, xml, csv, serialized)
Method: POST

Endpoint URL:

https://api.250ok.com/api/1.0/account/gdpr

Sample Output:

{
    "status": "success"
}

Parameters

Parameter Description Acceptable Values Required
requester_email The email address of the person submitting the GDPR request. Must match an active alias in the account. Valid email Y
requester_name The name of the person submitting the GDPR request. String Y
action The action you're requesting. 'export', ignore', 'delete' Y
users A comma-separate list of users to export, ignore, or delete. String Y

Status Responses

Status Description
success 'status' => 'success' indicates that the update was successful.
error An 'error' string will return specific errors related to data validation or permissions.

Error Responses

Description Code
Invalid 'action' value. Acceptable values are: export, ignore, or delete. 404
Invalid 'requester_name' value. Please provide the name of the person submitting the GDPR request. 404
Invalid 'requester_email' value. Please provide the email address of the person submitting the GDPR request. 404
Invalid 'users' value. You must provide the email address of the person(s) you\'re exporting, ignoring, or deleting. 404
Requester email@domain.com is not associated with your account. 404