API Tokens
To pass data into, or pull data from, the emfluence Marketing Platform via our API you will need an API Token. All tokens are tied to a specific user within your account. When logged in as the user you want the token tied to, you can find all existing tokens and create new tokens for that user on the Edit User page of your user. You can get to this page by clicking on the icon next to your username and clicking the Edit User button in the pop-up. If you are client admin, you can also go into the Options menu under System Users and click on your name to edit your user. Because the user's permissions will play a role in what they are allowed to do via the API, you may want to consider creating a specific API User to control the token.
NOTE: Reseller Users cannot create nor use access tokens as the token must be created and assigned to a client user created in the individual account, not the reseller gateway (the gateway is the only place for resellers can edit their security section). For reseller users, you will need to create a client user in that subaccount and then, logging in as that user, follow the same steps below.
Once on the Edit User page for your user, scroll to the bottom of the page. Under the Security section, you will need to type your password to access and change your username, email address, password, and API access tokens. This section is only visible to the user themselves (a client admin cannot edit another user's Security section). Type in your password and hit submit.
If your password is accepted, the section at the bottom of the user will unlock. Here you can edit the email address, username, and password for this user. Underneath you will also see all existing API tokens tied to the user. You will also see a button to create a new access token.
When making a new token, you will be given a pop-up to fill in two pieces of information about your token: a title and a description. If it ever becomes necessary for an emfluence developer to examine the calls for your token, and if you have more than one token active in your account, the more specific information available here the easier it will be. We'd suggest putting the use case and name (i.e. Zapier, Salesforce, WordPress, etc.) in both fields. After typing your information, click Save to create your token.
Once created, you will see your token. Because the token can act as a key to pull data out of your account or insert data into your account, this is the only time the full token will be shown.
After this point only the name, description, and the last 6 characters of the token will be visible (that information can be shared safely with emfluence if the need arises to examine the API calls made over this token). Copy the token and keep it somewhere safe. We suggest never sharing the token via email.
Once created, you can edit both the title and description by clicking the edit button just below the token. Editing these will not affect calls made over the token. You can also delete the token. This will affect calls made over the token. Because a token cannot be un-deleted, make sure before you delete a token you are sure you want the token deleted. If deleted, any integration using that token will stop passing data to and/or from the emfluence Marketing Platform. NOTE: If you delete a user with API Tokens assigned to them, those tokens will no longer function.You would need to create a new token for a different user and make updates to your integration.