Documentation Documentation

How to import existing keys into Tyk

You can use an API to import existing keys into Tyk.

This example uses standard authorization header authentication, and assumes that the Dashboard is located at and the Tyk secret is 352d20ee67be67f6340b4c0605b044b7 - update these as necessary to match your environment.

To import a key called abc, save the JSON contents as token.json (see example below), then run the following Curl command:

curl -H 'x-tyk-authorization: 352d20ee67be67f6340b4c0605b044b7' -H 'Content-Type: application/json'  -d @token.json

The following request will fail as the key doesn’t exist:

curl -H 'Authorization: invalid123'

But this request will now work, using the imported key:

curl -H 'Authorization: abc'

Example token.json file

  "allowance": 1000,
  "rate": 1000,
  "per": 60,
  "expires": -1,
  "quota_max": -1,
  "quota_renews": 1406121006,
  "quota_remaining": 0,
  "quota_renewal_rate": 60,
  "access_rights": {
    "3": {
      "api_name": "Tyk Test API",
      "api_id": "3"
  "org_id": "53ac07777cbb8c2d53000002",
  "basic_auth_data": {
    "password": "",
    "hash_type": ""
  "hmac_enabled": false,
  "hmac_string": "",
  "is_inactive": false,
  "apply_policy_id": "",
  "apply_policies": [
  "monitor": {
    "trigger_limits": []

See also the Keys section of the Gateway API Swagger doc.