Start developing

Create your Nocotax account

Finish the setup process

Follow the onboarding flow to enter your account details such as the default timezone and currency, the billing information of your own organization, and the tax configuration for your organization.

Unsure of your current tax configuration setup? You can still add/remove tax registrations later on.

Retrieve your API credentials

By default, all accounts have a total of three API credentials:

Type	Description
`Account ID`	An unique ID referencing your account. It’s used in the Basic Auth Scheme for API requests as the ID credential.
`Test API Key`	Authenticate requests on your server when you’re testing in a sandbox. By default, you can use this key to perform any API request without restriction. Reserve this key for testing and development to make sure you don’t accidentally modify your live data.
`Live API Key`	Authenticate requests on your server when in live mode. Don’t expose this key on a website or embed it in a mobile application. You can only use this key to perform any API request after subscribing to a paid plan

Your credentials are stored on the Developers settings tab in the dashboard.

Try changing the primary color to see an immediate difference!

Create a sample organization in Sandbox

You can begin exploring Nocotax APIs using the HTTPs client of your choice (curl, postman…), along with your API keys (see below).Operating in sandbox environment, you don’t have to worry about altering production data when doing the following tests.

To create an organization using the Nocotax API, send the following API request

curl -X POST https://api.nocotax.app/organizations \
-u ${ACCOUNT_ID}:${TEST_API_KEY} \
-d 'name=Test Customer' \
-d 'roles[]=BUYER' \
-d 'billing_address[country]=FR'

If everything worked, you should see a response, with a JSON body embeded, containing the ID of the newly created organization:
{ "id": "org_xxxxxxxxxxxx", "object": "organization", // ... }

Getting started

Billing and invoicing

Implementation Guides

Get started in three steps

Step 1: Create your Nocotax account and finish the setup process

Step 2: Send your first API request

​Get started in three steps

​Step 1: Create your Nocotax account and finish the setup process

​Step 2: Send your first API request

Get started in three steps

Step 1: Create your Nocotax account and finish the setup process

Step 2: Send your first API request