Guides
Read people and teams with SCIM 2.0
Bizisy runs a read-only SCIM 2.0 service (RFC 7643, RFC 7644) so an identity provider can read the company's people and teams straight from HR. Okta does this with a SCIM app set to import users ("Import New Users and Profile Updates").
Connect an identity provider#
- In Bizisy, an owner or admin opens Integrations → SCIM and creates a token. It is shown once. Bizisy keeps only a hash, and you can revoke it at any time.
- In the identity provider, set:
- Base URL:
https://api.bizisy.com/scim/v2 - Authentication: HTTP header,
Authorization: Bearer <token> - Unique identifier:
userName(the work email)
- Base URL:
- Run an import. People and teams change in Bizisy, so the identity provider only reads.
Microsoft Entra does not read SCIM servers for HR data (its inbound provisioning is push only). Use directory sync for Entra and Google Workspace.
What it returns#
| Path | Answer |
|---|---|
GET /ServiceProviderConfig | Filtering on (up to 200 results), patch, bulk, sort and ETags off, Bearer authentication. |
GET /ResourceTypes, GET /Schemas | User (with the enterprise extension) and Group. |
GET /Users, GET /Users/{id} | People. |
GET /Groups, GET /Groups/{id} | Teams, with the people in them today. |
POST, PUT, PATCH, DELETE | 501: the service is read only. |
Who is listed:
- Everyone who works at the company today.
- People starting within 14 days, with
active: falseuntil their first day. - People who left in the last 90 days, with
active: false.
What each user carries:
idandexternalId: Bizisy's id of the person.userNameandemails: the work email.name: the legal given and family name.displayName: the name the person goes by.title: today's job title.active: whether they work here today.- The enterprise extension's
department(today's team) andmanager.
Nothing private or about pay is ever included, and no change before the day it takes effect.
HTTP
GET /scim/v2/Users?filter=userName%20eq%20%22bea%40acme.pt%22 HTTP/1.1
Host: api.bizisy.com
Authorization: Bearer bzscim_…JSON
{
"schemas": ["urn:ietf:params:scim:api:messages:2.0:ListResponse"],
"totalResults": 1, "startIndex": 1, "itemsPerPage": 1,
"Resources": [{
"schemas": ["urn:ietf:params:scim:schemas:core:2.0:User", "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"],
"id": "01j…", "externalId": "01j…", "userName": "bea@acme.pt",
"name": { "givenName": "Bea", "familyName": "Silva", "formatted": "Bea Silva" },
"displayName": "Bea Silva", "emails": [{ "value": "bea@acme.pt", "type": "work", "primary": true }],
"title": "Engineer", "active": true,
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": { "department": "Engineering", "manager": { "value": "01j…", "displayName": "Ana Costa" } },
"meta": { "resourceType": "User", "created": "…", "lastModified": "…", "location": "https://api.bizisy.com/scim/v2/Users/01j…" }
}]
}Filters and paging#
- Operators:
eq ne co sw ew gt ge lt le pr, joined withand(which binds first) andor. Parentheses are not supported. - User attributes:
userName,externalId,id,displayName,active,title,emails/emails.value,name.givenName,name.familyName,meta.lastModified,meta.created, plus the enterprisedepartmentandmanager.value. - Group attributes:
displayName,externalId,id,members.value. - Case: text compares ignoring case; ids compare exactly.
- Unsupported filters answer
400withscimType: invalidFilter. - Paging:
startIndex(1-based) andcount(default 100, at most 200;0returns only the total).attributesandexcludedAttributesselect top-level attributes.
Limits and errors#
- Each token may make 300 requests a minute.
- The service answers only on
api.bizisy.com. A token belongs to the company and keeps working until it is revoked. - Errors use the SCIM error shape (
urn:ietf:params:scim:api:messages:2.0:Error, withstatusas a string):401for a missing or revoked token,403when the company's account is paused or closing,404for an unknown id.
Something missing or wrong on this page? Write to hello@bizisy.com.