---
title: "New-NectarTokenRegistration"
slug: "new-nectartokenregistration"
updated: 2026-07-23T16:50:58Z
published: 2026-07-23T16:50:58Z
canonical: "support.nectarcorp.com/new-nectartokenregistration"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.nectarcorp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# New-NectarTokenRegistration

Registers a Nectar DXP token for connecting to Nectar DXP using JWT

## Description

Registers a Nectar DXP token for connecting to Nectar DXP using JWT. One-time task required before attempting to access Nectar DXP APIs. Stored using Microsoft SecretManagement PS module. If SecretManagement PS module is is not installed, install via: Install-Module Microsoft.PowerShell.SecretManagement

There are several PS modules that connect to different secret providers. Install the one appropriate for your situation prior to running this command. For example, the PS SecretStore stores secrets on the local machine and can be installed via: Install-Module Microsoft.PowerShell.SecretStore

## Syntax

```
New-NectarTokenRegistration
  -CloudFQDN  <String>
  -Identifier  <String>
  -AccessToken  <String>
  -RefreshToken  <String>
  -DomainName  <String>
  -SecretVault  <String>
```

## Examples

### Example 1

```
New-NectarTokenRegistration -CloudFQDN contoso.nectar.services -AccessToken 'asdf987adfs987sadf' -RefreshToken '111111-1111-1111111-11111111' -DomainName contoso.com
```

Creates a token for contoso.nectar.services in the default vault.

## Parameters

**-CloudFQDN <String>** The FQDN of the Nectar DXP cloud.

| Parameter | Value |
| --- | --- |
| Required | true |
| Position | 1 |
| Default Value | None |
| Accept pipeline input? | true (ByValue) |
| Accept wildcard characters? | false |

**-Identifier <String>** An optional unique identifier (such as script name or username) to use when saving secrets to a secret store shared by multiple parties/scripts

| Parameter | Value |
| --- | --- |
| Required | false |
| Position | 2 |
| Default Value | None |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |

**-AccessToken <String>** The access token to use for connecting to Nectar DXP

| Parameter | Value |
| --- | --- |
| Required | true |
| Position | 3 |
| Default Value | None |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |

**-RefreshToken <String>** The refresh token used to refresh the Nectar DXP access token every 2 hours

| Parameter | Value |
| --- | --- |
| Required | true |
| Position | 4 |
| Default Value | None |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |

**-DomainName <String>** The domain name used in user logins (ie. contoso.com).

| Parameter | Value |
| --- | --- |
| Required | false |
| Position | 5 |
| Default Value | None |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |

**-SecretVault <String>** The name of the secret vault to install the secret. Use if installing to non-default secret vault

| Parameter | Value |
| --- | --- |
| Required | false |
| Position | 5 |
| Required | false |
| Default Value | None |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |