Create User
Creates a new user in your DocuSign account. Use this for programmatic user provisioning and account management.
Overview
- Purpose: Programmatically create new users in your DocuSign account.
- Use Cases: Automated user provisioning, employee onboarding, bulk user creation, integration with HR systems.
- API Method: POST /users
[!IMPORTANT] Requires appropriate account permissions to create users.
Required Input Fields
First Name: User’s first name.
Last Name: User’s last name.
Email: User’s email address - must be unique within the account.
Optional Input Fields
User Name: Display name for the user. If not provided, defaults to ‘FirstName LastName’.
Title: Job title or position.
Phone Number: Contact phone number.
Company: Company name.
Country Code: ISO country code (e.g., ‘US’, ‘GB’, ‘CA’).
Activation Access Code: Code for user activation (if required by account settings).
User Status: Initial status for the user account.
Settings: Object containing language and timezone preferences.
Settings Configuration
- Language: User interface language preference (e.g., ‘en’, ‘es’, ‘fr’).
- Time Zone: User’s timezone for date/time display (e.g., ‘America/New_York’, ‘Europe/London’).
Output
- User ID: Unique identifier for the created user in DocuSign.
- First Name: User’s first name.
- Last Name: User’s last name.
- Email: User’s email address.
Account Permissions
- Admin Rights: Creating users typically requires account administrator permissions.
- License Limits: Check account license limits before creating users.
- Email Uniqueness: Email addresses must be unique within the DocuSign account.
- Activation: Users may need to activate their accounts via email.
Tips
[!TIP] Verify account has available user licenses before creating users
[!TIP] Email addresses must be unique - check existing users first
[!TIP] Set appropriate language and timezone for better user experience
[!TIP] Store returned user IDs for future user management operations
[!TIP] Consider activation requirements based on account settings
[!TIP] Use bulk creation for onboarding multiple users efficiently