{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-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":["The Hook API uses Bearer token authentication. All requests must include an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}," header with a valid token."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Authorization: Bearer <your-token>\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"obtaining-a-token","__idx":1},"children":["Obtaining a token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tokens can be created and managed from ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://app.hook.co/profile/tokens"},"children":["app.hook.co"]},". From there you can view all currently issued tokens, see when each one expires, and revoke any token at any time."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"permissions","__idx":2},"children":["Permissions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each token is scoped to the permissions of the user who created it. API requests made with a token cannot exceed the access level of that user."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"expiry","__idx":3},"children":["Expiry"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tokens are issued with a custom expiry date. The maximum token lifetime is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["365 days"]},"."]}]},"headings":[{"value":"Authentication","id":"authentication","depth":1},{"value":"Obtaining a token","id":"obtaining-a-token","depth":2},{"value":"Permissions","id":"permissions","depth":2},{"value":"Expiry","id":"expiry","depth":2}],"frontmatter":{"seo":{"title":"Authentication"}},"lastModified":"2026-02-27T08:55:38.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/authentication","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}