POST /api/v1/identity-sources/{identitySourceId}/sessions/{sessionId}/bulk-groups-upsert
Uploads the group profiles without memberships that need to be inserted or updated in Okta from the identity source for the given session
Servers
- https://{yourOktaDomain}
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
sessionId |
String | Yes |
The ID of the identity source session |
identitySourceId |
String | Yes |
The ID of the identity source for which the session is created |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
profiles[] |
Array | No |
Array of group profiles that needs to be inserted or updated in Okta |
profiles[].profile |
Object | No |
Contains a set of external group attributes and their values that are mapped to Okta standard properties. See the group
|
profiles[].profile.description |
String | No |
Description of the group |
profiles[].profile.displayName |
String | No |
Name of the group |
profiles[].externalId |
String | No |
The external ID of the group that needs to be created or updated in Okta |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.