{"templateId":"markdown","versions":[{"version":"v2025-07-01","label":"2025-07-01","link":"/docs/v2025-07-01/authorization","default":false,"active":false,"folderId":"a2557b8d"},{"version":"v2025-08-01","label":"2025-08-01","link":"/docs/v2025-08-01/authorization","default":false,"active":false,"folderId":"a2557b8d"},{"version":"v2025-09-01","label":"2025-09-01 (Latest)","link":"/docs/authorization","default":true,"active":true,"folderId":"a2557b8d"}],"sharedDataIds":{"sidebar":"sidebar-docs/@v2025-07-01/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Authentication"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"authentication","__idx":0},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Requests use the HTTP Authorization header to both authenticate and authorize operations. The Convoy API accepts bearer tokens in this header. Bearer tokens are short-lived (24 hour expiration) and can be retrieved from our authentication endpoint and then sent as part of the request. You should receive a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<CLIENT_ID>"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<CLIENT_SECRET>"]}," from Convoy to make these requests."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["​​Retrieving a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<BEARER_TOKEN>"]}," in production:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"method\": \"post\",\n  \"url\": \"/oauth/token\",\n  \"baseUrl\": \"https://accounts.convoy.com\",\n  \"headers\": {\n    \"Content-Type\": \"application/json\"\n  },\n  \"body\": {\n    \"client_id\": \"<CLIENT_ID>\",\n    \"client_secret\": \"<CLIENT_SECRET>\",\n    \"audience\": \"https://developer.convoy.com\",\n    \"grant_type\": \"client_credentials\",\n    \"scope\": \"create:loads\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["​​Retrieving a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<BEARER_TOKEN>"]}," in demo:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"method\": \"post\",\n  \"url\": \"/oauth/token\",\n  \"baseUrl\": \"https://demo-accounts.convoy.com\",\n  \"headers\": {\n    \"Content-Type\": \"application/json\"\n  },\n  \"body\": {\n    \"client_id\": \"<CLIENT_ID>\",\n    \"client_secret\": \"<CLIENT_SECRET>\",\n    \"audience\": \"https://demo-developer.convoy.com\",\n    \"grant_type\": \"client_credentials\",\n    \"scope\": \"create:loads\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Making a request in production:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"method\": \"get\",\n  \"url\": \"https://developer.convoy.com/operation-name\",\n  \"headers\": {\n    \"Content-Type\": \"application/json\",\n    \"Authorization\": \"Bearer <BEARER_TOKEN>\",\n    \"X-Convoy-Api-Version\": \"2025-09-01\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Making a request in demo:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"method\": \"get\",\n  \"url\": \"https://demo-developer.convoy.com/operation-name\",\n  \"headers\": {\n    \"Content-Type\": \"application/json\",\n    \"Authorization\": \"Bearer <BEARER_TOKEN>\",\n    \"X-Convoy-Api-Version\": \"2025-09-01\"\n  }\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Authentication","id":"authentication","depth":1}],"frontmatter":{"seo":{"title":"Authentication"}},"lastModified":"2026-08-10T16:41:50.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/authorization","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}