Capabilities
Additional functionality:
The Blackline connector supports automatic account provisioning for user accounts and entity assignments. Team membership and role assignment remain read-only.
- Create Blackline accounts without a password. The connector requires a username, first name, last name, email, and time zone ID. The username is sent as Blackline’s
loginIdstring (for example,sample.user); it is not the numeric userid. The time zone ID is Blackline’s numerictimeZoneId, which Blackline requires to create a user. Valid values are listed by Blackline’s Time Zone API; thetime_zone_idprofile field of any synced Blackline account holds a value your tenant accepts. Accounts are created inactive by default because Blackline can reject creating an active user; set the optional Active field totrueonly if your tenant accepts it. - Start Blackline’s asynchronous account deprovision process. Blackline disables the account and removes its access assignments instead of hard-deleting it. C1 evaluates Blackline’s immediate response, but it does not track a failure that happens later while Blackline finishes the process in the background.
- Assign and remove entities for a user. Blackline requires a user to have an entity assigned before the user can be made active.
- Enable or disable a Blackline user with the connector actions below. Accounts are created inactive, so assign an entity first and then run
enable_user.
Connector actions
Connector actions are custom capabilities that extend C1 automations with app-specific operations. Which automation step offers an action is determined by the action itself — you cannot choose:user_id is Blackline’s numeric user id, which is the account’s resource ID in C1; the account selector supplies it.
Gather Blackline configuration information
Configuring the connector requires you to pass in information from Blackline. Gather these configuration details before you move on. Here’s the information you’ll need:- Client ID
- Client Secret
- Username
- Password (API key)
- Scope
- Environment Subdomain
https://{environment}.api.blackline.com (for example us, eu, or sbeu). This is the BlackLine region, not your company or instance name.
Scope must contain the API scope name(s) plus your instance identifier, entered as instance_<GUID> and separated by spaces — for example:
bl.mdm scope in addition to bl.users.
The exact scope names and your instance GUID are unique to your instance and are provided by the BlackLine support team — enter the values BlackLine gives you rather than the placeholder above, and include a scope for each resource the connector syncs (users, teams, entities, and roles). If the instance_<GUID> token is omitted, authentication fails with invalid_grant: Invalid instance GUID.
The connector uses the following endpoints:
- User management API
GET /v1/usersPOST /v1/usersPOST /v1/users/{id}/deprovisionGET /v1/users/{id}PUT /v1/users/{id}GET /v1/users/{id}/teamsGET /v1/users/{id}/entitiesPOST /v1/users/{id}/entitiesDELETE /v1/users/{id}/entities/{entityId}
- Team management API
GET /v1/teamsGET /v1/teams/{teamId}/users
- Master Data (MDM Entities) API
GET /v1/mdm/entities
- Role Management API
GET /v1/roles
View the Blackline developer documentation
Configure the Blackline connector
- Cloud-hosted
- Self-hosted
Follow these instructions to use a built-in, no-code connector hosted by C1.Done. Your Blackline connector is now pulling access data into C1.
1
In C1, navigate to Apps > Connectors and click Add connector.
2
Search for Blackline and click Add.
3
Choose where to add the connector: Create a new app, or Add to an existing app (then select the app).If you’re creating a new app, choose whether to link it to an application discovered from your identity provider: select Yes and pick the IdP application, or No to continue with just the connector.
4
Set the connector’s Name and, optionally, a Description.
5
Click the pencil icon next to Owners to choose who can configure and manage this connector.
6
Click Add. The connector is created and its configuration page opens.
7
Find the Settings area of the page and click Edit.
8
Enter the configuration information from the previous section.
9
Click Save.
10
The connector’s label changes to Syncing, followed by Connected. You can view the logs to ensure that information is syncing.