f

REST API

How to get your Nozbe API key

To generate your API token, open your Nozbe account -> Settings -> API tokens and click “Add new token.”

API Tokens

You can create a new token there and name it, for example, “Nozbe API.” You can generate more tokens to use with different integrations/apps.

Use apikey <API_token> as Authorization header when accessing Nozbe REST API.

How to Use interactive API documentation

  1. Go to Nozbe API interactive documentation at https://api4.nozbe.com/v1/api
  2. Select Authorize and provide apikey <API_token>
  1. Start using interactive API documentation by selecting “Try it out” on the endpoint and executing requests with Execute.

How to generate API clients with OpenAPI Generator

Nozbe provides an OpenAPI 3.0 document at:

https://api4.nozbe.com/v1/api/openapi.yaml

Generating client code with OpenApi Generator (https://openapi-generator.tech/) can simplify integration with Nozbe API.

You can find the list of available client generators here:

https://openapi-generator.tech/docs/generators#client-generators

Exemplary Ruby integration with Nozbe API:

  1. Install OpenAPI Generator https://openapi-generator.tech/docs/installation/
  2. Generate client code with (“ruby” can be replaced with another available generator):
openapi-generator-cli generate -i https://api4.nozbe.com/v1/api/openapi.yaml -g ruby -o /tmp/test/
  1. If the README.md file was generated, follow instructions from this file to compile and set up the client. Make sure to use apikey <API_token> as the Authorization header. You can now use generated client methods to communicate with the Nozbe server. Below is an example of using generated Ruby client methods to get a Single Tasks project and create a task and a comment.