Eng
Creating an API key
integration

In Nova Post, an API key is used to identify the user and create JWT tokens. JWT tokens ensure authentication and security for requests. After generation, the token is added to the header of each request to verify user access rights.

How to create a key for a European client

  1. 1
    Create an account in the My Nova Post cabinet

    Register at my.novapost.com. Step-by-step registration instructions 
  2. 2
    Affiliate an individual to the organization
    • 2.1
      Write an email to the NovaPost sales manager.
    • 2.2
      In the letter, provide the tax code and the name of the organization, details of the individual: full name, phone number, email.

      The details of the individual must match those for which the account in the My Nova Post cabinet was or will be registered.
  3. 3
    Send a request for the generation of an API key

    The request must be submitted on behalf of the person designated as the trusted representative of the company.
    • 3.1
    • 3.2
      Subject of the email: "API NovaPost. Generation of keys for using the API functionality"
    • 3.3
      Content of the letter:
      • 3.3.1
        Tax code and name of the organization
      • 3.3.2
        Phone number registered to the account
      • 3.3.3
        Full name of the account owner
      • 3.3.4
        Specify whether access to the test environment, the production environment, or both is needed

Receiving keys

The regulated processing time for the request is 8 hours. API keys will be sent to the specified email.

How to create a key for a client from Ukraine

Generate keys in the Business account in Ukraine under the "Settings - Security" section. Direct link to the section. 

  • Step-by-step instructions:

    1. Log in to the business cabinet at new.novaposhta.ua as a legal entity. 
    2. Go to the "Settings" section
    3. Select the "Security" section
    4. Click "Create key"
    5. The key has been created. Copy the code for using the Nova Post API

Additional Recommendations

  • 1
    Security: Keep your API keys in a secure place and do not share them with third parties.
  • 2
    Testing: Use the test environment to verify the integration before moving to the production environment.
  • 3
    Access Control: Regularly review the list of users who have access to your account and API keys.