---
title: BlackLine API Integration on Truto
slug: blackline
category: Accounting
canonical: "https://truto.one/integrations/detail/blackline/"
---

# BlackLine API Integration on Truto



**Category:** Accounting  
**Status:** Beta

## Unified APIs

### Unified User Directory API

- **Groups** — Groups are a collection of users in the source application. In some applications, they might also be called Teams.
- **Me** — 
- **Role Assignments** — 
- **Roles** — The Role object represents a role of a User.
- **Users** — The User object represents a User.

## How it works

1. **Link your customer's BlackLine account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach BlackLine.** The Proxy API is a 1-to-1 mapping of the BlackLine API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

- **Automate SOX-compliant user deprovisioning across financial systems** — Identity and GRC platforms can sync user lifecycle events to BlackLine in real time, ensuring terminated employees lose access to sensitive financial close data immediately — a critical SOX audit requirement.
- **Centralize role-based access control for accounting platforms** — IT management and security SaaS products can read and manage BlackLine role assignments alongside other enterprise apps, giving admins a single pane of glass for RBAC across their customers' financial tool stack.
- **Sync employee directories into BlackLine for seamless onboarding** — HRIS and workforce management platforms can automatically provision new finance team members into BlackLine with the correct roles and group memberships, eliminating manual admin setup during onboarding.
- **Enforce segregation of duties policies across financial systems** — GRC and audit readiness platforms can continuously monitor BlackLine user roles and group assignments to detect segregation-of-duties conflicts and flag violations before auditors do.

## What you can build

- **Automated BlackLine user provisioning and deprovisioning** — Automatically create, update, and deprovision BlackLine user accounts when employee status changes in your customers' HRIS or identity provider.
- **Cross-platform role assignment dashboard** — Display a unified view of BlackLine roles and role assignments alongside other connected apps so admins can audit access from one screen.
- **Group membership sync from identity providers** — Keep BlackLine group memberships in sync with teams and departments defined in upstream directory sources like Okta, Azure AD, or Google Workspace.
- **Segregation of duties conflict detection** — Continuously scan BlackLine role assignments and flag users who hold conflicting roles that violate your customers' SoD policies.
- **Real-time access review reports for auditors** — Generate on-demand or scheduled reports showing which users have access to BlackLine, their roles, and group memberships to satisfy SOX and internal audit requests.

## FAQs

### What authentication method does BlackLine's API use?

BlackLine's Open API platform uses OAuth 2.0 with Bearer tokens. Truto handles the full auth flow so your team doesn't need to manage token exchange or refresh logic.

### Which BlackLine resources are available through Truto's Unified User Directory API?

Truto's Unified User Directory API maps to BlackLine's Users, Groups, Roles, Role Assignments, and Me endpoints, covering the core identity and access management surface area.

### Are BlackLine-specific tools like period management or data ingestion available today?

Not yet. BlackLine-specific tools (e.g., period management, transaction ingestion, task management) are built on request. Contact Truto to scope the exact endpoints you need and we'll build them for you.

### Can I deprovision users in BlackLine through Truto?

BlackLine exposes an asynchronous deprovision endpoint for users. Truto can support this operation — reach out to confirm availability or request it as a custom tool.

### How does Truto handle pagination and rate limits for BlackLine?

Truto abstracts away BlackLine's pagination and rate-limiting behavior behind a consistent interface. You make standard API calls and Truto manages retries, cursor tracking, and throttling under the hood.

### Who typically connects their BlackLine account in an end-user flow?

Usually a Financial Systems Admin or IT Operations lead who has admin-level access to BlackLine. They authorize the OAuth connection, and Truto securely stores and manages the credentials on behalf of your application.