Permissions: Creating an API User

API users are only required when using REST Engaging Network Services (ENS)

To use our ENS REST API, you will need to create a new API user in Engaging Networks to generate the API key.

To do this, you first need to login with your subaccount login details. 

Creating an API User

An API User is not a standard user, and they cannot log into the system. An API user can only access the system via REST.

Once logged in as the subaccount administrator go to the Hello menu at the top, and then to Account settings, and Users on the left.

To create a new API User, click on Add API User. You can also edit any existing API Users here. The user needs the following:

Field Description
Email address

This will be the user id.

Note: Although we require the user ids you create to be in the form of email addresses, they do not necessarily need to be valid addresses, as we won’t send emails to them. However, if you want to be able to initiate a password reset without contacting a super admin, it will need to be valid.

Display name

The full name of the user

First name

User’s first name

Last name User’s last name
Remote Address

This should be the local IP address(es) of the API user which will be whitelisted.

Note: You can designate multiple IP addresses by separating them with a ~ and no spaces. There is a maximum of 200 characters.

Note: If you are receiving the error “Authentication call is being made from an unregistered source address for this ENS api key”, this is likely caused by the IP address making the request not matching this/these values.

Group

This will be the permission group the user belongs to.

Note: if this API User is to only ‘Process a page’, then having no user group is a valid option. However, if the API User is intended to use the ‘Supporter Services’ calls, a permission group with the permission ‘Manage individual supporters’ (under Data Management) enabled, must be assigned.

Status

The current status of their User. Active, Pending, or Inactive are the allowed options.

 

Once you have filled in the required information click:

This will create/save the user and create a unique API key for them to use. This token can now be used with REST ENS. If you wish to revoke a key at any time, you can click on the user name and then click the Revoke button shown below.

Updated on January 29, 2020

Was this article helpful?

Need Support?
Can’t find the answer you’re looking for? Don’t worry we’re here to help!
Contact Support