AdminApi | NexPort User Documentation

Used to retrieve an authentication token for NexPort API Requests.

post

Used to retrieve an authentication token for NexPort API Requests. Will not work for system operators or users with the customer service role. The client makes a request to the token endpoint by adding the following parameters using the "application/x-www-form-urlencoded" format per Appendix B with a character encoding of UTF-8 in the HTTP request entity-body.

Body

Contains information for obtaining an authentication token

usernamestringRequired

Username for user requesting token

passwordstringRequired

Password for user requesting token

grant_typestringRequired

Only "password" is supported currently

scopestringOptional

Scope of the access request

utc_expiration_datestring · date-timeOptional

Optional expiration date for the token (set to null for no expiration)

Responses

200

Authentication Token Information

403

Unable to authenticate

422

Validation exception. See response body for more info.

post

/api/v1/AdminApi/Authenticate

POST /api/v1/AdminApi/Authenticate HTTP/1.1
Host: www.nexportcampus.com
Content-Type: application/json
Accept: */*
Content-Length: 121

{
  "username": "text",
  "password": "text",
  "grant_type": "text",
  "scope": "text",
  "utc_expiration_date": "2026-02-08T22:19:03.368Z"
}

{
  "access_token": "00000000-0000-0000-0000-000000000000",
  "token_type": "text",
  "expires_in": 1,
  "api_error_entity": {
    "error_code": 0,
    "error_message": "text",
    "warning_messages": [
      "text"
    ]
  }
}

Used to determine whether an access token is valid or not. Returns either the expiration date or a message describing why the token is invalid. If there is no expiration on the token, then it will just return the generic api_error_entity with the no error error code.

get

Query parameters

access_tokenstring · uuidRequired

Responses

200

Validation results

422

Validation exception. See response body for more info.

get

/api/v1/AdminApi/ValidateAccessToken

GET /api/v1/AdminApi/ValidateAccessToken?access_token=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: www.nexportcampus.com
Accept: */*

{
  "utc_expiration_date": "2026-02-08T22:19:03.368Z",
  "error_message": "text",
  "api_error_entity": {
    "error_code": 0,
    "error_message": "text",
    "warning_messages": [
      "text"
    ]
  }
}

Creates a user with the information specified by request. Requires the Create Users permission in the specified owner org or any ancestors.

post

Query parameters

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Body

Contains fields for creating a new user

owner_org_idstring · uuidRequired

Id of the user's owner organization

Example: 00000000-0000-0000-0000-000000000000

loginstringRequired

The login for this account

passwordstringRequired

The password for this account

first_namestringRequired

First name of the user

middle_namestringOptional

Middle name of the user

last_namestringRequired

Last name of the user

emailstringOptional

Email address of the user

titlestringOptional

User's title prefix

nicknamestringOptional

User's nickname

Responses

200

Id of created user

403

Not authorized to create a user

409

Entity not found or duplicate login

422

Validation exception

post

/api/v1/AdminApi/CreateUser

POST /api/v1/AdminApi/CreateUser?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Content-Type: application/json
Accept: */*
Content-Length: 448

{
  "owner_org_id": "00000000-0000-0000-0000-000000000000",
  "login": "text",
  "password": "text",
  "first_name": "text",
  "middle_name": "text",
  "last_name": "text",
  "email": "text",
  "title": "text",
  "nickname": "text",
  "contact_info": {
    "address_line_1": "text",
    "address_line_2": "text",
    "city": "text",
    "state": "text",
    "country": "text",
    "postal_code": "text",
    "phone": "text",
    "mobile": "text",
    "fax": "text",
    "caption": "text",
    "api_error_entity": {
      "error_code": 0,
      "error_message": "text"
    }
  }
}

{
  "user_id": "00000000-0000-0000-0000-000000000000",
  "api_error_entity": {
    "error_code": 0,
    "error_message": "text",
    "warning_messages": [
      "text"
    ]
  }
}

Gets a user based on login string OR user id. Requires the View Users permission in either the user's owner org, its ancestors, or any of the user's subscription organizations, or their ancestors.

get

Query parameters

loginstringOptional

Login of the user to get

user_idstring · uuidOptional

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Responses

200

User information

403

Not authorized to view users

409

Entity not found

422

Validation exception

get

/api/v1/AdminApi/GetUser

GET /api/v1/AdminApi/GetUser?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Accept: */*

{
  "user_id": "00000000-0000-0000-0000-000000000000",
  "owner_org_id": "00000000-0000-0000-0000-000000000000",
  "owner_org_short_name": "text",
  "last_name": "text",
  "middle_name": "text",
  "first_name": "text",
  "email": "text",
  "internal-email": "text",
  "title": "text",
  "nickname": "text",
  "owner_org_name": "text",
  "owner_org": {
    "org_id": "00000000-0000-0000-0000-000000000000",
    "name": "text",
    "short_name": "text",
    "api_error_entity": {
      "error_code": 0,
      "error_message": "text",
      "warning_messages": [
        "text"
      ]
    }
  },
  "api_error_entity": {
    "error_code": 0,
    "error_message": "text",
    "warning_messages": [
      "text"
    ]
  }
}

Validates a user's login/password combination and returns a user response. The calling account must have the view users permision in the user's owner org or one of their subscription orgs.

get

Query parameters

loginstringRequired

User's nexport username

passwordstringRequired

User's password

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Responses

200

User information

403

Not authorized to view users

409

Entity not found

422

Validation exception

get

/api/v1/AdminApi/AuthenticateUser

GET /api/v1/AdminApi/AuthenticateUser?login=text&password=text&access_token=text HTTP/1.1
Host: www.nexportcampus.com
Accept: */*

{
  "user_id": "00000000-0000-0000-0000-000000000000",
  "owner_org_id": "00000000-0000-0000-0000-000000000000",
  "owner_org_short_name": "text",
  "last_name": "text",
  "middle_name": "text",
  "first_name": "text",
  "email": "text",
  "internal-email": "text",
  "title": "text",
  "nickname": "text",
  "owner_org_name": "text",
  "owner_org": {
    "org_id": "00000000-0000-0000-0000-000000000000",
    "name": "text",
    "short_name": "text",
    "api_error_entity": {
      "error_code": 0,
      "error_message": "text",
      "warning_messages": [
        "text"
      ]
    }
  },
  "api_error_entity": {
    "error_code": 0,
    "error_message": "text",
    "warning_messages": [
      "text"
    ]
  }
}

Returns all the users with at least a partial match to the search term as part of their login, first name, last name, or email. Sorted by last name, first name, then login, in alphabetical order. This will only search in organizations in which the method caller has the appropriate permissions. Requires the View Users permission.

get

Query parameters

search_termstringOptional

pageinteger · int32Optional

Which page of results to start on

per_pageinteger · int32Optional

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Responses

200

List of users

403

Not authorized to view users

422

Validation exception. See response body for more info.

get

/api/v1/AdminApi/GetUsers

GET /api/v1/AdminApi/GetUsers?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Accept: */*

[
  {
    "user_id": "00000000-0000-0000-0000-000000000000",
    "owner_org_id": "00000000-0000-0000-0000-000000000000",
    "owner_org_short_name": "text",
    "last_name": "text",
    "middle_name": "text",
    "first_name": "text",
    "email": "text",
    "internal-email": "text",
    "title": "text",
    "nickname": "text",
    "owner_org_name": "text",
    "owner_org": {
      "org_id": "00000000-0000-0000-0000-000000000000",
      "name": "text",
      "short_name": "text",
      "api_error_entity": {
        "error_code": 0,
        "error_message": "text",
        "warning_messages": [
          "text"
        ]
      }
    },
    "api_error_entity": {
      "error_code": 0,
      "error_message": "text",
      "warning_messages": [
        "text"
      ]
    }
  }
]

Get contact information for a user based on their user id or their login. Throws a ValidationException if both user_id and login fields are present. Requires the View User Profiles permission in either the user's owner org, its ancestors, or any of the user's subscription organizations, or their ancestors.

get

Query parameters

user_idstring · uuidOptional

loginstringOptional

Login of the user to get the contact information for

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Responses

200

Address and contact information

403

Not authorized to view user contact information

409

Entity not found

422

Validation exception

get

/api/v1/AdminApi/GetUserContactInformation

GET /api/v1/AdminApi/GetUserContactInformation?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Accept: */*

{
  "user_id": "00000000-0000-0000-0000-000000000000",
  "address_line_1": "text",
  "address_line_2": "text",
  "city": "text",
  "state": "text",
  "country": "text",
  "postal_code": "text",
  "phone": "text",
  "mobile": "text",
  "fax": "text",
  "caption": "text",
  "api_error_entity": {
    "error_code": 0,
    "error_message": "text",
    "warning_messages": [
      "text"
    ]
  }
}

Creates a group under the given parent group or organization. Requires the AddGroup permission in the specified parent or one of it's ancestors.

post

Query parameters

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Body

namestringRequired

The name of the new group

short_namestringRequired

Short name must be unique within the system...if any other groups have the same group name then an error will be thrown

billing_codestringRequired

Any string value that can be used for tracking groups later

descriptionstringRequired

Description of the group

parent_idstring · uuidRequired

ID of the group or organization that this new group will be created under.

Example: 00000000-0000-0000-0000-000000000000

Responses

200

Id of created group

403

Not authorized to create a group in the given parent

409

Entity not found or duplicate login

422

Validation exception. See response body for more info.

post

/api/v1/AdminApi/CreateGroup

POST /api/v1/AdminApi/CreateGroup?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Content-Type: application/json
Accept: */*
Content-Length: 129

{
  "name": "text",
  "short_name": "text",
  "billing_code": "text",
  "description": "text",
  "parent_id": "00000000-0000-0000-0000-000000000000"
}

{
  "group_id": "00000000-0000-0000-0000-000000000000",
  "api_error_entity": {
    "error_code": 0,
    "error_message": "text",
    "warning_messages": [
      "text"
    ]
  }
}

Creates memberships in each of the given groups. This call is atomic. If one membership creation fails then they will all fail. Requires the AddMembership permission in the specified group or one of it's ancestors.

post

Query parameters

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Body

Create membership request object

groupsstring · uuid[]Required

The the groups to give the user a membership in

user_idstring · uuidRequired

ID of the user to give memberships in each of the listed groups. The user must have subscriptions in the orgs that the groups belong to.

Example: 00000000-0000-0000-0000-000000000000

Responses

200

Memberships were successfully created

403

Not authorized to add memberships to the given group

409

Entity not found or duplicate login

422

Validation exception. See response body for more info.

post

/api/v1/AdminApi/CreateMembership

POST /api/v1/AdminApi/CreateMembership?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Content-Type: application/json
Accept: */*
Content-Length: 100

{
  "groups": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "user_id": "00000000-0000-0000-0000-000000000000"
}

{
  "memberships": [
    {
      "membership_id": "00000000-0000-0000-0000-000000000000",
      "group_id": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "api_error_entity": {
    "error_code": 0,
    "error_message": "text",
    "warning_messages": [
      "text"
    ]
  }
}

Remove memberships in each of the given groups. This call is atomic. If one membership removal fails then they will all fail.

post

Requires either a user Id and the list of group Ids OR the list of membership Ids.

###Permission requirements Requires the RemoveMemberships permission in the specified group or one of it's ancestors.

Query parameters

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Body

Remove membership request object

groupsstring · uuid[]Optional

The list of membership group Ids to be removed

user_idstring · uuidOptional

The user Id that will be used to remove the group membership(s)

Example: 00000000-0000-0000-0000-000000000000

membershipsstring · uuid[]Optional

The list of membership Ids to be removed

Responses

200

Memberships were successfully removed

403

Not authorized to remove memberships from the given group

409

Entity not found or duplicate login

422

Validation exception. See response body for more info.

post

/api/v1/AdminApi/RemoveMembership

POST /api/v1/AdminApi/RemoveMembership?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "groups": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "user_id": "00000000-0000-0000-0000-000000000000",
  "memberships": [
    "00000000-0000-0000-0000-000000000000"
  ]
}

{
  "memberships": [
    {
      "membership_id": "00000000-0000-0000-0000-000000000000",
      "group_id": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "api_error_entity": {
    "error_code": 0,
    "error_message": "text",
    "warning_messages": [
      "text"
    ]
  }
}

Edits user information

post

Edits user information (including contact information) based on given input. Use either user_id OR login to specify the user to edit. If a field is not passed in, the value will remain unchanged. ###Permission requirements

For editing your own profile:

Editing contact information requires the Edit User Profile permission.

For editing another profile:

Requires the View User Profiles permission.
Editing basic information (primary email, prefix title, nickname) requires the Edit User Profile permission.
Editing name (first, middle, last) requires the Edit User Profile permission AND the target user's owner organization must have Allow Admin User Edit set to true.
Editing contact information requires the Edit User Profile permission.

Query parameters

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Body

Contains fields for editing a user's profile

user_idstring · uuidOptional

Id of the user whose information is being edited. Use either this OR login.

Example: 00000000-0000-0000-0000-000000000000

loginstringOptional

Login of the user whose information is being edited. User either this OR user_id.

first_namestringOptional

First name of the user

middle_namestringOptional

Middle name of the user

last_namestringOptional

Last name of the user

emailstringOptional

User's email address

titlestringOptional

User's title prefix

nicknamestringOptional

User's nickname

Responses

200

Edited user information

403

Not authorized to view/edit users

409

Entity not found

422

Validation exception

post

/api/v1/AdminApi/EditUser

POST /api/v1/AdminApi/EditUser?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Content-Type: application/json
Accept: */*
Content-Length: 425

{
  "user_id": "00000000-0000-0000-0000-000000000000",
  "login": "text",
  "first_name": "text",
  "middle_name": "text",
  "last_name": "text",
  "email": "text",
  "title": "text",
  "nickname": "text",
  "contact_info": {
    "address_line_1": "text",
    "address_line_2": "text",
    "city": "text",
    "state": "text",
    "country": "text",
    "postal_code": "text",
    "phone": "text",
    "mobile": "text",
    "fax": "text",
    "caption": "text",
    "api_error_entity": {
      "error_code": 0,
      "error_message": "text"
    }
  }
}

{
  "user_id": "00000000-0000-0000-0000-000000000000",
  "api_error_entity": {
    "error_code": 0,
    "error_message": "text",
    "warning_messages": [
      "text"
    ]
  }
}

Creates a subscription with the information specified by request. Requires the Add Subscriptions permission.

post

Query parameters

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Body

Contains fields for creating a new subscription

org_idstring · uuidRequired

Id of the subscription's organization

Example: 00000000-0000-0000-0000-000000000000

user_idstring · uuidRequired

The user id to create the subscription for

Example: 00000000-0000-0000-0000-000000000000

Responses

200

Id of created subscription

403

Not authorized to create a subscription

409

Entity not found or duplicate subscription

422

Validation exception

post

/api/v1/AdminApi/CreateSubscription

POST /api/v1/AdminApi/CreateSubscription?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Content-Type: application/json
Accept: */*
Content-Length: 98

{
  "org_id": "00000000-0000-0000-0000-000000000000",
  "user_id": "00000000-0000-0000-0000-000000000000"
}

{
  "subscription_id": "00000000-0000-0000-0000-000000000000",
  "api_error_entity": {
    "error_code": 0,
    "error_message": "text",
    "warning_messages": [
      "text"
    ]
  }
}

Gets subscription information for the user in the organization.

get

Gets subscription information for the user in the organization. Valid parameter combinations are:

user_id and org_short_name
user_id and org_id
subscription_id

###Permissions Requires the View User Subscriptions permission in the subscription organization or an ancestor.

Query parameters

user_idstring · uuidOptional

org_short_namestringOptional

org_idstring · uuidOptional

subscription_idstring · uuidOptional

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Responses

200

Subscription information

403

Not authorized to view subscriptions

409

Entity not found

422

Validation exception

get

/api/v1/AdminApi/GetSubscription

GET /api/v1/AdminApi/GetSubscription?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Accept: */*

{
  "subscription_id": "00000000-0000-0000-0000-000000000000",
  "user_id": "00000000-0000-0000-0000-000000000000",
  "org_id": "00000000-0000-0000-0000-000000000000",
  "org_name": "text",
  "org_shortname": "text",
  "utc_date_created": "2026-02-08T22:19:03.368Z",
  "utc_date_updated": "2026-02-08T22:19:03.368Z",
  "billing_code": "text",
  "utc_expiration_date": "2026-02-08T22:19:03.368Z",
  "is_disabled": true,
  "subscription_status": {
    "current_status_name": "text",
    "previous_status_name": "text",
    "status_date_set": "2026-02-08T22:19:03.368Z"
  },
  "api_error_entity": {
    "error_code": 0,
    "error_message": "text",
    "warning_messages": [
      "text"
    ]
  }
}

Deprecated

Get subscription information for a user or an organization.

get

Use either user_id OR login OR org_id. If searching by user, results will be ordered by the subscription UtcExpirationDate from earliest to latest. If searching by org, results will be ordered by the subscription user last name then first name in alphabetical order. Requires the View User Subscriptions permission in the target user's organization if viewing user subscriptions and the Add, Remove, or Update Subscriptions permission in the given organization if viewing organization subscriptions.

Query parameters

user_idstring · uuidOptional

loginstringOptional

Login of the user to get subscriptions for

org_idstring · uuidOptional

pageinteger · int32Optional

Which page of results to start on

per_pageinteger · int32Optional

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Responses

200

List of subscriptions

403

Not authorized to view subscriptions

409

Entity not found

422

Validation exception

get

/api/v1/AdminApi/GetSubscriptions

GET /api/v1/AdminApi/GetSubscriptions?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Accept: */*

[
  {
    "subscription_id": "00000000-0000-0000-0000-000000000000",
    "user_id": "00000000-0000-0000-0000-000000000000",
    "org_id": "00000000-0000-0000-0000-000000000000",
    "org_name": "text",
    "org_shortname": "text",
    "utc_date_created": "2026-02-08T22:19:03.368Z",
    "utc_date_updated": "2026-02-08T22:19:03.368Z",
    "billing_code": "text",
    "utc_expiration_date": "2026-02-08T22:19:03.368Z",
    "is_disabled": true,
    "subscription_status": {
      "current_status_name": "text",
      "previous_status_name": "text",
      "status_date_set": "2026-02-08T22:19:03.368Z"
    },
    "api_error_entity": {
      "error_code": 0,
      "error_message": "text",
      "warning_messages": [
        "text"
      ]
    }
  }
]

Search subscription information for a user or an organization.

post

At least one user id OR one org id must be specified.

Results will be ordered by the subscription Creation Date from earliest to latest. ###Permissions Requires the View User Subscriptions permission in the target user's organization if viewing user subscriptions and the Add, Remove, or Update Subscriptions permission in the given organization if viewing organization subscriptions.

Query parameters

pageinteger · int32Optional

The request page of results

per_pageinteger · int32Optional

Number of results to return on each page

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Body

user_idsstring · uuid[]Optional

Limit the results to only subscriptions for these users

org_idsstring · uuid[]Optional

Limit the results to only subscriptions to these organizations

utc_expires_beforestring · date-timeOptional

Only return subscriptions expiring before this date

utc_expires_afterstring · date-timeOptional

Only return subscriptions expiring after this date

utc_create_beforestring · date-timeOptional

Only return subscriptions createa before this date

utc_create_afterstring · date-timeOptional

Only return subscriptions created AFTER this date

Responses

200

Subscription search results successfully returned

403

Not authorized to view subscriptions

409

Entity not found

422

Validation exception

post

/api/v1/AdminApi/SearchSubscriptions

POST /api/v1/AdminApi/SearchSubscriptions?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Content-Type: application/json
Accept: */*
Content-Length: 386

{
  "user_ids": [
    "4b655fc8-6b89-48cd-9f37-1a605ac07e64",
    "22e15163-791e-4636-bafe-9c0acaf45171"
  ],
  "org_ids": [
    "f759827a-8e5a-4b6f-86b0-d7379e18f1b9",
    "a89d881b-03c4-44aa-a4a7-143c929fad65"
  ],
  "utc_expires_before": "2026-02-08T22:04:21.8586819Z",
  "utc_expires_after": "2028-02-08T22:04:21.8586819Z",
  "utc_create_before": "2026-02-07T22:04:21.8586819Z",
  "utc_create_after": "2026-01-19T22:04:21.8586819Z"
}

{
  "subscriptions": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "subscription_id": "00000000-0000-0000-0000-000000000000",
      "user_id": "00000000-0000-0000-0000-000000000000",
      "org_id": "00000000-0000-0000-0000-000000000000",
      "org_name": "Test Organization",
      "org_shortname": "testorg",
      "utc_date_created": "0001-01-01T00:00:00",
      "is_disabled": false,
      "api_error_entity": {
        "error_code": 0,
        "warning_messages": []
      }
    }
  ],
  "page": 5,
  "page_size": 15,
  "total_count": 28,
  "api_error_entity": {
    "error_code": 0,
    "warning_messages": []
  }
}

Enables or disables a subscription. Requires the Update Subscriptions permission in the subscription organization or an ancestor.

post

Query parameters

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Body

Contains information for enabling or disabling a subscription

subscription_idstring · uuidRequired

Id of the subscription to enable or disable

Example: 00000000-0000-0000-0000-000000000000

disablebooleanOptional

Enable or disable this subscription. Setting this to false enables the subscription. Setting it to true will disable it.

Responses

200

Whether the subscription is disabled after the method call

403

Not authorized to update subscriptions

409

Entity not found

422

Validation exception. See response body for more info.

post

/api/v1/AdminApi/DisableSubscription

POST /api/v1/AdminApi/DisableSubscription?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Content-Type: application/json
Accept: */*
Content-Length: 73

{
  "subscription_id": "00000000-0000-0000-0000-000000000000",
  "disable": true
}

{
  "subscription_id": "00000000-0000-0000-0000-000000000000",
  "disabled": true,
  "api_error_entity": {
    "error_code": 0,
    "error_message": "text",
    "warning_messages": [
      "text"
    ]
  }
}

Sets the Subscription Status on the Subscription.

post

Sets the subscription status for the supplied subscriber. Subscription status name is case sensitive and must be a pre existing status. This action will not create a status that does not exist. You can send an empty string for the subscription status if you want to set it back to the default subscription status. ###Permissions Requirements Requires the Update Subscriptions permission in the specified org or an ancestor.

Query parameters

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Body

subscription_idstring · uuidRequired

The Subscription Id

Example: 00000000-0000-0000-0000-000000000000

subscription_statusstringRequired

The status that should be set on this subscription. Use empty string to set the subscription status to the default subscription status.

Responses

200

Subscription Id, Current Subscription Status, Previous Subscription Status, and the date the new Subscription Status was set

403

Not authorized to update subscriptions

409

Subscription or Subscription Status not found

422

Validation exception. See response body for more info.

post

/api/v1/AdminApi/SetSubscriptionStatus

POST /api/v1/AdminApi/SetSubscriptionStatus?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "subscription_id": "00000000-0000-0000-0000-000000000000",
  "subscription_status": "text"
}

{
  "subscription_id": "00000000-0000-0000-0000-000000000000",
  "current_subscription_status": "text",
  "previous_scubscription_status": "text",
  "status_date_set": "2026-02-08T22:19:03.368Z",
  "api_error_entity": {
    "error_code": 0,
    "error_message": "text",
    "warning_messages": [
      "text"
    ]
  }
}

Gets all the custom profile fields available to an organization, or a field matching an id in a given org.

get

Will throw a CustomFieldNotFound exception if no custom profile field exists with the given field id.

Query parameters

org_idstring · uuidRequired

field_idstring · uuidOptional

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Responses

200

List of custom profile fields

409

Entity not found

422

Validation exception. See response body for more info.

get

/api/v1/AdminApi/GetCustomProfileFields

GET /api/v1/AdminApi/GetCustomProfileFields?org_id=123e4567-e89b-12d3-a456-426614174000&access_token=text HTTP/1.1
Host: www.nexportcampus.com
Accept: */*

[
  {
    "field_id": "00000000-0000-0000-0000-000000000000",
    "name": "text",
    "key": "text",
    "description": "text",
    "type": 0,
    "org_id": "00000000-0000-0000-0000-000000000000",
    "org_short_name": "text",
    "api_error_entity": {
      "error_code": 0,
      "error_message": "text",
      "warning_messages": [
        "text"
      ]
    }
  }
]

Gets the custom profile field values based on the given criteria, with DateTime fields being in UTC.

get

Valid argument combinations are: subscriber_id; user_id and org_id; subscriber_id and key; user_id, org_id, and key. Requires the View User Profiles permission for the subscription organization or an ancestor.

Query parameters

subscriber_idstring · uuidOptional

user_idstring · uuidOptional

org_idstring · uuidOptional

keystringOptional

Key of the custom profile field to get the value for

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Responses

200

List of custom profile field values

403

Not authorized to view user profiles

409

Entity not found

422

Validation exception

get

/api/v1/AdminApi/GetCustomProfileFieldValues

GET /api/v1/AdminApi/GetCustomProfileFieldValues?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Accept: */*

[
  {
    "name": "text",
    "key": "text",
    "value": "text",
    "org_id": "00000000-0000-0000-0000-000000000000",
    "org_short_name": "text",
    "field_id": "00000000-0000-0000-0000-000000000000",
    "type": 0,
    "utc_date_modified": "2026-02-08T22:19:03.368Z",
    "api_error_entity": {
      "error_code": 0,
      "error_message": "text",
      "warning_messages": [
        "text"
      ]
    }
  }
]

Sets the custom profile field values for a subscription based on the subscriber id and key/value pairs in the request.

post

All fields that can be set will be set and any fields that are not found will be ignored. Warnings will be added to the {Nexport.WebApi.Model.v1.ApiErrorEntity} property's warnings collection and the ItemNotFound error code set. ###Permissions This method requires the Edit User Profile permission in the subscription organization or an ancestor.

Query parameters

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Body

Contains id of the subscription and the custom fields/values to set

subscriber_idstring · uuidRequired

Id of the subscription to set the custom values for

Example: 00000000-0000-0000-0000-000000000000

Responses

200

Error information

403

Not authorized to edit profiles

409

Entity not found

422

Validation exception. See response body for more info.

post

/api/v1/AdminApi/SetCustomProfileFieldValues

POST /api/v1/AdminApi/SetCustomProfileFieldValues?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Content-Type: application/json
Accept: */*
Content-Length: 246

{
  "subscriber_id": "1c6220c5-9d24-44d9-9d54-73ca2083b170",
  "subscriber_pair": {
    "user_id": "bc265aad-f8a2-4087-a2fc-02fbe64e46b8",
    "org_id": "673a1b42-a7ab-4583-8c7d-9e6d75504e31"
  },
  "custom_profile_field_values": {
    "gender": "male",
    "badge_number": "5434533"
  }
}

{
  "message": "text",
  "api_error_entity": {
    "error_code": 0,
    "error_message": "text",
    "warning_messages": [
      "text"
    ]
  }
}

Returns a list of organizations and groups that matches the search term with their name or short name. Each item in the list will contain the id of the organization/group, name, short name and the type. Results are in alphabetical order by name followed by the short name.

get

Query parameters

search_operatorinteger · enumRequired

0 = Disjunction, 1 = Conjunction

Possible values:

base_org_idstring · uuidRequired

namestringOptional

The organization/group name

short_namestringOptional

pageinteger · int32Optional

Which page of results to start on

per_pageinteger · int32Optional

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Responses

200

List of organizations and groups

409

Entity not found

422

Validation exception

get

/api/v1/AdminApi/SearchDirectory

GET /api/v1/AdminApi/SearchDirectory?search_operator=0&base_org_id=123e4567-e89b-12d3-a456-426614174000&access_token=text HTTP/1.1
Host: www.nexportcampus.com
Accept: */*

[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "parent_org_id": "00000000-0000-0000-0000-000000000000",
    "name": "text",
    "short_name": "text",
    "type": 1,
    "api_error_entity": {
      "error_code": 0,
      "error_message": "text",
      "warning_messages": [
        "text"
      ]
    }
  }
]

Returns a list of sub organizations (as well as the parent organization) corresponding to the given id or short name. Each item in the list will contain the org id, org name, and org short name. Results are in alphabetical order by org name.

get

Query parameters

org_idstring · uuidOptional

org_short_namestringOptional

pageinteger · int32Optional

Which page of results to start on

per_pageinteger · int32Optional

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Responses

200

List of organizations

409

Entity not found

422

Validation exception

get

/api/v1/AdminApi/GetOrganizations

GET /api/v1/AdminApi/GetOrganizations?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Accept: */*

[
  {
    "org_id": "00000000-0000-0000-0000-000000000000",
    "name": "text",
    "short_name": "text",
    "api_error_entity": {
      "error_code": 0,
      "error_message": "text",
      "warning_messages": [
        "text"
      ]
    }
  }
]

Checks if the given user has permission on a group.

post

Query parameters

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Body

Model used for Request

user_idstring · uuidRequired

The User Id

Example: 00000000-0000-0000-0000-000000000000

group_idstring · uuidRequired

The Group Id

Example: 00000000-0000-0000-0000-000000000000

permissionstringRequired

The Permission. From PermissionAttribute on Role Properties.

Responses

200

Is Permitted

403

Not authorized to view groups

409

Entity not found

422

Validation exception. See response body for more info.

post

/api/v1/AdminApi/HasGroupPermission

POST /api/v1/AdminApi/HasGroupPermission?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Content-Type: application/json
Accept: */*
Content-Length: 120

{
  "user_id": "00000000-0000-0000-0000-000000000000",
  "group_id": "00000000-0000-0000-0000-000000000000",
  "permission": "text"
}

{
  "is_permitted": true,
  "api_error_entity": {
    "error_code": 0,
    "error_message": "text",
    "warning_messages": [
      "text"
    ]
  }
}

Searches for groups on which the given user has permission.

post

Query parameters

access_tokenstringRequired

Use the AdminApi Authenticate method to get the access_token

Body

The Request object used for AdminApiController.SearchGroupsForPermission

user_idstring · uuidRequired

The User Id

Example: 00000000-0000-0000-0000-000000000000

org_idstring · uuidRequired

The Organization Id to look for permissions under.

Example: 00000000-0000-0000-0000-000000000000

permissionstringRequired

The Permission Attribute Name Value from the Role class

pageinteger · int32Optional

The page to return

per_pageinteger · int32Optional

The number of items per page

Responses

200

List of organizations and groups

403

Not authorized to search for groups

422

Validation exception. See response body for more info.

post

/api/v1/AdminApi/SearchGroupsForPermission

POST /api/v1/AdminApi/SearchGroupsForPermission?access_token=text HTTP/1.1
Host: www.nexportcampus.com
Content-Type: application/json
Accept: */*
Content-Length: 140

{
  "user_id": "00000000-0000-0000-0000-000000000000",
  "org_id": "00000000-0000-0000-0000-000000000000",
  "permission": "text",
  "page": 1,
  "per_page": 1
}

{
  "groups": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "parent_org_id": "00000000-0000-0000-0000-000000000000",
      "name": "text",
      "short_name": "text",
      "type": 1,
      "api_error_entity": {
        "error_code": 0,
        "error_message": "text",
        "warning_messages": [
          "text"
        ]
      }
    }
  ],
  "page": 1,
  "page_size": 1,
  "total_count": 1,
  "api_error_entity": {
    "error_code": 0,
    "error_message": "text",
    "warning_messages": [
      "text"
    ]
  }
}

hashtagUsed to retrieve an authentication token for NexPort API Requests.

hashtagUsed to determine whether an access token is valid or not. Returns either the expiration date or a message describing why the token is invalid. If there is no expiration on the token, then it will just return the generic api_error_entity with the no error error code.

hashtagCreates a user with the information specified by request. Requires the Create Users permission in the specified owner org or any ancestors.

hashtagGets a user based on login string OR user id. Requires the View Users permission in either the user's owner org, its ancestors, or any of the user's subscription organizations, or their ancestors.

hashtagValidates a user's login/password combination and returns a user response. The calling account must have the view users permision in the user's owner org or one of their subscription orgs.

hashtagCreates a group under the given parent group or organization. Requires the AddGroup permission in the specified parent or one of it's ancestors.

hashtagCreates memberships in each of the given groups. This call is atomic. If one membership creation fails then they will all fail. Requires the AddMembership permission in the specified group or one of it's ancestors.

hashtagRemove memberships in each of the given groups. This call is atomic. If one membership removal fails then they will all fail.

hashtagEdits user information

hashtagCreates a subscription with the information specified by request. Requires the Add Subscriptions permission.

hashtagGets subscription information for the user in the organization.

hashtagGet subscription information for a user or an organization.

hashtagSearch subscription information for a user or an organization.

hashtagEnables or disables a subscription. Requires the Update Subscriptions permission in the subscription organization or an ancestor.

hashtagSets the Subscription Status on the Subscription.

hashtagGets all the custom profile fields available to an organization, or a field matching an id in a given org.

hashtagGets the custom profile field values based on the given criteria, with DateTime fields being in UTC.

hashtagSets the custom profile field values for a subscription based on the subscriber id and key/value pairs in the request.

hashtagReturns a list of organizations and groups that matches the search term with their name or short name. Each item in the list will contain the id of the organization/group, name, short name and the type. Results are in alphabetical order by name followed by the short name.

hashtagReturns a list of sub organizations (as well as the parent organization) corresponding to the given id or short name. Each item in the list will contain the org id, org name, and org short name. Results are in alphabetical order by org name.

hashtagChecks if the given user has permission on a group.

hashtagSearches for groups on which the given user has permission.

Used to retrieve an authentication token for NexPort API Requests.

Used to determine whether an access token is valid or not. Returns either the expiration date or a message describing why the token is invalid. If there is no expiration on the token, then it will just return the generic api_error_entity with the no error error code.

Creates a user with the information specified by request. Requires the Create Users permission in the specified owner org or any ancestors.

Gets a user based on login string OR user id. Requires the View Users permission in either the user's owner org, its ancestors, or any of the user's subscription organizations, or their ancestors.

Validates a user's login/password combination and returns a user response. The calling account must have the view users permision in the user's owner org or one of their subscription orgs.

Creates a group under the given parent group or organization. Requires the AddGroup permission in the specified parent or one of it's ancestors.

Creates memberships in each of the given groups. This call is atomic. If one membership creation fails then they will all fail. Requires the AddMembership permission in the specified group or one of it's ancestors.

Remove memberships in each of the given groups. This call is atomic. If one membership removal fails then they will all fail.

Edits user information

Creates a subscription with the information specified by request. Requires the Add Subscriptions permission.

Gets subscription information for the user in the organization.

Get subscription information for a user or an organization.

Search subscription information for a user or an organization.

Enables or disables a subscription. Requires the Update Subscriptions permission in the subscription organization or an ancestor.

Sets the Subscription Status on the Subscription.

Gets all the custom profile fields available to an organization, or a field matching an id in a given org.

Gets the custom profile field values based on the given criteria, with DateTime fields being in UTC.

Sets the custom profile field values for a subscription based on the subscriber id and key/value pairs in the request.

Returns a list of organizations and groups that matches the search term with their name or short name. Each item in the list will contain the id of the organization/group, name, short name and the type. Results are in alphabetical order by name followed by the short name.

Returns a list of sub organizations (as well as the parent organization) corresponding to the given id or short name. Each item in the list will contain the org id, org name, and org short name. Results are in alphabetical order by org name.

Checks if the given user has permission on a group.

Searches for groups on which the given user has permission.