API keys

From Account Settings, you can set up company information, access API keys, view Blueshift-provided Amazon S3 bucket details, and so on.

API keys

Perform the following steps to access the API keys section:

• Click the hamburger menu next to your user name in the top right corner.
• Click Account Settings.
• Navigate to the API Keys tab.
  • Note that access to view API keys depends on your assigned access level.

The API keys section contains the following:

• Site ID: A unique identifier for your account, required in API requests to specify your site. For example, in the API URL https://api.getblueshift.com/api/v1/resource?site_id=<site_id>, replace <site_id> with your account’s Site ID.
• Event API Key: Used to authenticate event data sent to Blueshift when event verification is enabled.
• Event Verification Key: Used to validate the authenticity of events. Keep this key private and do not expose it publicly.
• Event Signatures Generated Using: Specifies the hashing algorithm used to generate event signatures for verification. You can choose between SHA-256 and MD5. For more details, see Event verification (signed events).
• User API Key: Used to programmatically read and write data in your Blueshift account. Regenerating this key immediately expires the previous key.
• Blueshift API Password: A system-generated password for basic authentication with Blueshift APIs. Generated on request and stored securely in your account.
• Amazon S3 Folder Details: Provides access credentials and the folder path to interact with your S3 storage for file-based imports and exports. Keep these credentials secure.
• Auth Token for Census Integration: A secure token used to authenticate your Census integration. Keep this token private.
• Email Validation Key: Used to authenticate API requests for email address validation. This key is required when using the email validation APIs. For details, see Email address validation.

Amazon S3 bucket

Blueshift uses the Blueshift Customer bucket in AWS to store data, reports, and audit trail logs.

The Amazon S3 Folder Details are available in the API Keys tab. Use this information to read from and write to your S3 folder.

S3 bucket:

EU region: bsft-prod-euw1-customers/<site_name>/
Rest of the world: bsft-customers/<site_name>/

• Only users with the Admin role can access the S3 folder credentials.
• You can manually regenerate your S3 Folder Access Key. The key is valid for 6 months from the date it is generated.

Note: Admins may receive an email prompting them to regenerate the S3 Folder Access Key. If you are not using the key, regeneration is not required.