UserImport: closeBulkUserImportRequest

Required scopes: user_write

Given a CSV list of users, close their accounts.

Your CSV import file is made up of a header row with the column headers and a row of user or account data for each user whose account you want to close.

To ensure your CSV is properly formatted, use the Sample Bulk Update CSV file as a template. The following table describes the columns.

Column Required Description
AccountID yes The user's 32-character API account ID of the user's account in your organization. This can be found in the in the API and Keys section of the account.
AccountName The name of the user's account in your organization. The account name must match the account ID provided.
FirstName yes The user's first name.
LastName yes The user's last name.
UserEmail yes The user's complete email address.
PermissionSet yes The user's permission set. The PermissionSet value must match an existing permission set for the account. This value is not case sensitive.

Request

HTTP request

POST /v2/organizations/{organizationId}/imports/bulk_users/close

Parameters

Parameter NameValueDescription
Path Parameters
organizationIdstring

The organization ID Guid

Responses

CodeDescriptionReference
200

OK

UserImport

SDK Method

BulkOperations::closeBulkUserImportRequest

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.

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.

}} />