{"id":23977,"date":"2026-07-13T09:14:13","date_gmt":"2026-07-13T03:44:13","guid":{"rendered":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/?post_type=article&#038;p=23977"},"modified":"2026-08-14T07:49:21","modified_gmt":"2026-08-14T02:19:21","slug":"api-key-generation","status":"publish","type":"article","link":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/article\/api-key-generation\/","title":{"rendered":"API Key Generation"},"content":{"rendered":"<h2>Overview<\/h2>\n<p>An API key is a secure token that lets an Administrator authenticate requests to the Nimble REST APIs for <strong>Organization-level Integration Resources<\/strong> \u2014 such as Users, Projects, and Team Members. Using this key, you can programmatically access Nimble data from your own applications or integration tools, without signing in through the web interface each time.<\/p>\n<p>API key generation is one part of using the <strong>Nimble REST API<\/strong>. For an overview of the REST API and how to authenticate your requests, see <a target=\"_blank\" href=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/article\/nimble-rest-api\/\" rel=\"noopener\">Nimble REST API<\/a>.<\/p>\n<h2>Navigation<\/h2>\n<p>In the left panel, select <strong>Account Space<\/strong>. Then, from the top panel, go to <strong>Administration<\/strong> and select <strong>API Key Generation<\/strong>.<\/p>\n<p><a href=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/07\/admin-menu2-masked.png\"><img decoding=\"async\" style=\"max-width: 100%; height: auto; border: 1px solid #ddd;\" src=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/07\/admin-menu2-masked.png\" alt=\"Navigate to Account Space, Administration, API Key Generation\" \/><\/a><\/p>\n<h2>Generate an API Key<\/h2>\n<p>The API Key Generation screen opens with an <strong>Expiry date<\/strong> field and the <strong>Generate API Key<\/strong> button.<\/p>\n<p><a href=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/07\/apikey-01-screen.png\"><img decoding=\"async\" style=\"max-width: 100%; height: auto; border: 1px solid #ddd;\" src=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/07\/apikey-01-screen.png\" alt=\"API Key Generation screen\" \/><\/a><\/p>\n<ol>\n<li>Click the <strong>Expiry date<\/strong> field and select the date on which you want the key to stop working. The key remains valid until the end of this date.<a href=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/07\/apikey-02-date.png\"><img decoding=\"async\" style=\"max-width: 100%; height: auto; border: 1px solid #ddd;\" src=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/07\/apikey-02-date.png\" alt=\"Select an expiry date for the API key\" \/><\/a><\/li>\n<li>Click <strong>Generate API Key<\/strong>.<\/li>\n<li>Your new API key is generated and displayed. Click the <strong>Copy<\/strong> icon next to the key and store it in a safe place.<a href=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/07\/apikey-03-generated-masked.png\"><img decoding=\"async\" style=\"max-width: 100%; height: auto; border: 1px solid #ddd;\" src=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/07\/apikey-03-generated-masked.png\" alt=\"API key generated with a Copy icon\" \/><\/a><\/li>\n<\/ol>\n<h2>How It Works<\/h2>\n<p>The generated key is shown <strong>only once<\/strong>, at the time of generation. For security, Nimble does not store or display it again \u2014 so make sure you copy and save it before leaving the screen. If you lose the key, generate a new one.<\/p>\n<p>The key stays active until the <strong>expiry date<\/strong> you set. After that date, any request made with the key is rejected, and you need to generate a new key to continue.<\/p>\n<h2>Use the API Key with the Nimble REST APIs<\/h2>\n<p>Once you have your API key, you use it to authenticate calls to the Nimble REST API for Organization-level Integration Resources. You can also explore and try every available API from the interactive Swagger documentation page. For the full steps, see <a target=\"_blank\" href=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/article\/nimble-rest-api\/\" rel=\"noopener\">Nimble REST API<\/a>.<\/p>\n<h2>Important Points<\/h2>\n<ul>\n<li>Only an <strong>Administrator<\/strong> can generate an API key from the API Key Generation screen.<\/li>\n<li>The API key is displayed only once. Copy and store it securely as soon as it is generated.<\/li>\n<li>The key carries the <strong>Administrator&#8217;s personal access permissions<\/strong> \u2014 other users accessing Nimble data via this key do so under the Administrator&#8217;s identity. Treat it like a password and never share it beyond authorized integrations.<\/li>\n<li>The key is currently used for <strong>Organization-level Integration Resources<\/strong> \u2014 Users, Projects, and Team Members.<\/li>\n<li>Set an appropriate expiry date. Once the key expires, generate a new one to continue accessing the APIs.<\/li>\n<\/ul>\n<div class=\"helpful-block-content wth-theme-thumbs\" data-title=\"\" >\n<ul>\n<li><span class=\"wth-title\">Was this helpful?<\/span><\/li>\n<li><a data-post=\"23977\" data-post-url=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/article\/api-key-generation\/\" data-post-title=\"API Key Generation\" data-response=\"1\" href=\"#\" class=\"wth-green-btn icon-thumbsup\">Yes<\/a>&nbsp; &nbsp;<a data-response=\"0\" data-post=\"23977\" data-post-url=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/article\/api-key-generation\/\" data-post-title=\"API Key Generation\" href=\"#\" class=\"wth-red-btn icon-thumbsdown\">No<\/a><\/li>\n<\/ul>\n<\/div>","protected":false},"author":4,"featured_media":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","multi-rating":{"mr_rating_results":[]},"_links":{"self":[{"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/article\/23977"}],"collection":[{"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/article"}],"about":[{"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/types\/article"}],"author":[{"embeddable":true,"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/comments?post=23977"}],"version-history":[{"count":10,"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/article\/23977\/revisions"}],"predecessor-version":[{"id":24086,"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/article\/23977\/revisions\/24086"}],"wp:attachment":[{"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/media?parent=23977"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}