NetBird Full API Reference + Read-Only MCP Prototype
POST/api/reverse-proxies/proxy-tokens

Create a Proxy Token

Generate an account-scoped proxy access token for self-hosted proxy registration

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 body fields
expires_inintegeroptional
Token expiration in seconds (0 = never expires)
namestringrequired
Human-readable token name

5 status codes
200Proxy token created (plain token shown once)
created_atstringrequired
expires_atstringoptional
idstringrequired
last_usedstringoptional
namestringrequired
revokedbooleanrequired
plain_tokenstringrequired
The plain text token (shown only once)
400Bad Request
401Requires authentication
403Forbidden
500Internal Server Error

Error handling

A 400 is returned: Bad Request. A 401 is returned: Requires authentication. A 403 is returned: Forbidden. A 500 is returned: Internal Server Error.