Get your free trail of Salsa

Nodes & Organizations

To use the API you will need to know some basic information about your organization. This will include:

  • The node you are on.
  • Your organization_KEY.
  • Your campaign manager username (email address).
  • Your campaign manager password.
  • Your headquarters URL.

By taking note of this information from the start you will be fully prepared to troubleshoot problems with the API.

Throughout our documentation you will see URLs like http://sample.nodeurl.tld. Replace this URL with the base portion of your headquarters URL. This could be similar to http://sandbox.salsalabs.org. This references your ACTUAL account. Trying to use your campaign manager with a different node will not work. By default, campaign managers DO NOT have accounts on the sandbox node.

Definitions

  • Node - A node within Salsa refers to the specific cluster of web servers and databases that your information is served from. Common node names are org, wfc, org2, etc.
  • Organization KEY - A unique identifier used to collocate all of the data related to your organization within Salsa.
  • Campaign Manager Username - This is the username used to log into the headquarters for your organization. A campaign manager username is most often the email address of the person to whom the account is assigned. An organization may have multiple campaign managers. Additionally, campaign managers can be created specifically for developed web applications to provide more granular control.
  • Campaign Manager Password - The secret identifier used in combination with a Campaign Manager Username to grant access to Salsa resources for an organization.
  • Headquarters URL - The exact address typed into a web browser in order to access the administrative img for Salsa.