UserImport: getBulkUserImportRequests

Required scopes: user_read

Gets a list of all of the user import requests.

Request

HTTP request

GET /v2/organizations/{organizationId}/imports/bulk_users

Parameters

Parameter NameValueDescription
Path Parameters
organizationIdstring

The organization ID Guid

SDK Method

BulkOperations::getBulkUserImportRequests

Definitions

DocuSign.Account.Common.Models.RestApi.Response.OrganizationImportResponseRequestor

The person who initiated the import request.

namestring

The name of the requestor.

idstring

The unique ID of the requestor. If type is user, this is the requestor's user ID.

typestring

The type of the requestor. One of:

  • user
  • client_app

emailstring

The email address of the requestor.

DocuSign.Account.Common.Models.RestApi.Response.OrganizationImportResponseErrorRollup

A description of how importing failed.

error_typestring

The type of error. One of:

  • no_action_taken_user_exists
  • user_added
  • user_updated
  • invalid_column_header
  • invalid_row_data
  • insufficient_row_data_found
  • extra_row_data_found
  • blank_username
  • invalid_characters_in_username
  • invalid_useremail_address
  • email_domain_is_reserved
  • new_name_with_existing_useremail_not_allowed
  • invalid_characters_in_jobtitle
  • invalid_membership_id
  • membership_not_in_account
  • maximum_users_exceeded
  • invalid_permissionset
  • user_permissionset_problems
  • invalid_group
  • user_group_problems
  • group_and_permissionset_problems
  • column_headers_missing
  • invalid_csv_data_or_syntax
  • invalid_characters_in_companyname
  • invalid_language_code
  • username_column_header_missing
  • useremail_column_header_missing
  • permissionset_column_header_missing
  • membership_id_column_header_usage_not_permitted
  • administrator_group_assignment_not_permitted
  • user_awaiting_activation
  • account_admin_access_denied
  • invalid_characters_in_address
  • permissionset_required
  • apiusername_column_header_missing
  • invalid_apiusername
  • useremail_username_combination_exists
  • permissionset_change_not_allowed
  • username_language_changes_ignored_warning
  • invalid_country_warning
  • invalid_account_id
  • invalid_autoactivate
  • invalid_loginpolicy
  • autoactivate_not_allowed
  • membership_closed
  • membership_closed_or_disabled_warning
  • cannot_close_last_active_admin
  • no_action_taken
  • cannot_close_own_membership
  • unspecified_error

countinteger

The number of errors of this type.

DocuSign.Account.Common.Models.RestApi.Response.OrganizationImportResponseWarningRollup

A list of user-level warnings.

warning_typestring

The type of warning.

countinteger

The number of warnings of this type.

DocuSign.Account.Common.Models.RestApi.Response.OrganizationImportsResponse

A list of responses to user import requests.

imports[UserImport]

A list of responses to user import requests.

UserImport

User import operations.

idstring

The unique ID of the import request. You can pass this value to the getBulkUserImportRequest method to return the status, details, and metadata for the bulk export data

typestring

The type of import requested. One of:

  • add_users
  • update_users
  • close_users

requestorDocuSign.Account.Common.Models.RestApi.Response.OrganizationImportResponseRequestor

The person who initiated the request.

createdstring

Date and time that the request was created.

last_modifiedstring

Date and time that the request was last modified.

statusstring

The status of the request. One of:

  • queued
  • processed_with_issues
  • processed_with_errors
  • failed
  • completed

user_countinteger

The number of user rows in the import request.

processed_user_countinteger

The number of valid user rows processed.

added_user_countinteger

The number of users added to an account.

updated_user_countinteger

The number of existing users updated.

closed_user_countinteger

The number of user accounts closed.

no_action_required_user_countinteger

The number of users that required no action; they were not added, updated, or closed. This typically happens when you import an existing user.

error_countinteger

The number of errors encountered during the import.

See the rollup properties below for details of the errors.

warning_countinteger

The number of warnings raised during the import.

invalid_column_headersstring

A comma-separated list of invalid column headers in the CSV file.

imports_not_found_or_not_available_for_accountsstring

A list of users for whom it was not possible to create an account.

file_level_error_rollups[DocuSign.Account.Common.Models.RestApi.Response.OrganizationImportResponseErrorRollup]

A list of file-level errors.

user_level_error_rollups[DocuSign.Account.Common.Models.RestApi.Response.OrganizationImportResponseErrorRollup]

A list of user-level errors.

user_level_warning_rollups[DocuSign.Account.Common.Models.RestApi.Response.OrganizationImportResponseWarningRollup]

A list of user-level warnings.

has_csv_resultsboolean

If true, the results_uri returns valid CSV content.

results_uristring

A URI you can use to retrieve the results.

}} />