Configuring the Veza integration for BlackLine
Last updated
Was this helpful?
The Veza integration for BlackLine enables gathering User, Group and Role assignments from the BlackLine financial automation platform.
Create a BlackLine user for API access
The user must have the API Role and be a System Administrator to make the necessary requests
Generate an API key for the user for the BlackLine API Administration Portal or Financial Close System
Request OAuth 2.0 credentials from the BlackLine customer support team:
Required API features: Accounts
Required scopes: bl_users, bl_mdm
Their team should return a PDF with the OAuth app credentials. Use this support-provided installation form to configure the integration on Veza.
For more detail on obtaining credentials and BlackLine API keys, see in the official developer documentation.
On the Veza Integrations page, add a BlackLine Integration with the following fields:
Name - integration name
URL - URL for BlackLine instance from installation form e.g. https://us.api.blackline.com
Username - Username of BlackLine user for the integration
API Key - API key generated for the user
Client ID - The Client ID from the support-provided installation form
Client Secret - The Client Secret from the installation form
Instance ID - UUID-type string from the Installation form Scope following the instance_. Do not include the scope strings such as bl.users bl.mdm.
NOTE: Please contact Blackline Customer Support if you need the values for URL, Username, API key, Client ID, Client Secret and Instance ID.
id
User login
name
User full name as configured in BlackLine
is_active
Boolean True if user is active
email
User's configured email
job_title
User's Job Title if set in BlackLine
id
BlackLine Group ID
name
Group name
level_name
Name of Group Level
unique_code
BlackLine unique code for Group (short name)
parent_id
ID of Parent Group if child
name
Product Name
name
Role Name
Roles are assigned to Users or Groups to either BlackLine Application or specific BlackLine Product (resource) as configured in BlackLine.