# Bulk Update Email Accounts ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /account/bulk-update: put: summary: Bulk Update Email Accounts deprecated: false description: >- This endpoint allows you to modify various settings for multiple email accounts simultaneously, including basic information, daily limits, signatures, warmup settings, and rampup configurations. Only provided fields will be updated; omitted fields remain unchanged. operationId: bulkUpdateEmailAccounts tags: - Email Account - Email Accounts parameters: - name: x-api-key in: header description: Your PlusVibe.ai account's API Key required: false example: '' schema: type: string requestBody: content: application/json: schema: type: object required: - workspace_id - ids properties: workspace_id: type: string pattern: ^[a-f0-9]{24}$ description: Workspace identifier. examples: - 507f1f77bcf86cd799439011 ids: type: array items: type: string pattern: ^[a-f0-9]{24}$ minItems: 1 description: Array of email account IDs to update (minimum 1 required) examples: - - 507f1f77bcf86cd799439012 - 507f1f77bcf86cd799439013 - 507f1f77bcf86cd799439014 first_name: type: string description: First name for the email accounts examples: - John last_name: type: string description: Last name for the email accounts examples: - Doe daily_limit: type: integer minimum: 0 description: Maximum number of emails to send per day examples: - 100 interval_limit_in_min: type: integer minimum: 1 description: Minimum interval between emails in minutes examples: - 5 signature: type: string description: Email signature content (html) examples: - |- Best regards, John Doe Sales Manager Acme Corp Phone: +1-555-123-4567 Email: john.doe@acmecorp.com clear_signature: type: string enum: - 'yes' - 'no' description: Set to 'yes' to clear the signature field examples: - 'no' reply_to: type: string format: email description: Reply-to email address examples: - support@acmecorp.com clear_reply_to: type: string enum: - 'yes' - 'no' description: Set to 'yes' to clear the reply_to field examples: - 'no' bulk_is_slow_rampup: type: string enum: - 'yes' - 'no' description: Enable slow rampup for campaign sending (yes/no) examples: - 'yes' bulk_rampup_daily_limit: type: integer minimum: 1 description: Initial daily limit for campaign rampup examples: - 50 bulk_rampup_daily_inc: type: integer minimum: 1 description: Daily increment for campaign rampup examples: - 10 warmup_custom_words: type: string description: Custom words for warmup emails examples: - >- business, meeting, proposal, partnership, collaboration, opportunity, discussion, follow-up warmup_max_daily_limit: type: integer minimum: 1 description: Maximum daily warmup emails examples: - 30 warmup_initial_daily_limit: type: integer minimum: 1 description: Initial daily warmup limit for rampup examples: - 5 warmup_pace_increment: type: integer minimum: 1 description: 'Daily increment for warmup rampup ' examples: - 2 warmup_signature: type: string enum: - 'yes' - 'no' description: Include signature in warmup emails (yes/no) examples: - 'yes' warmup_randomize: type: string enum: - 'yes' - 'no' description: Randomize warmup email timing (yes | no) examples: - 'yes' warmup_randomize_num: type: integer minimum: 1 description: Randomization number (e.g. 20 means +/-20%) examples: - 15 warmup_reply_rate: type: number minimum: 0 maximum: 1 description: Reply rate for warmup emails (0.0 to 1.0) examples: - 0.25 bulk_warmup_is_slow_rampup: type: string enum: - 'yes' - 'no' description: Enable slow rampup for warmup (yes/no) examples: - 'yes' warmup_schedule: type: object description: Warmup schedule configuration properties: tz: type: string description: Timezone for warmup schedule examples: - America/New_York from_time: type: string pattern: ^([01]\d|2[0-3]):([0-5]\d)$ description: Start time for warmup (24-hour format) examples: - '09:00' to_time: type: string pattern: ^([01]\d|2[0-3]):([0-5]\d)$ description: End time for warmup (24-hour format) examples: - '17:00' days: type: array items: type: string enum: - Monday - Tuesday - Wednesday - Thursday - Friday - Saturday - Sunday minItems: 5 description: Days of the week for warmup (minimum 5 days) examples: - - Monday - Tuesday - Wednesday - Thursday - Friday required: - tz - from_time - to_time - days x-apidog-orders: - tz - from_time - to_time - days examples: - tz: America/New_York from_time: '09:00' to_time: '17:00' days: - Monday - Tuesday - Wednesday - Thursday - Friday warmup_business_type: type: string enum: - Artificial Intelligence and Machine Learning - Consulting Firms - Cryptocurrency and Blockchain - Digital Marketing Agencies - E-commerce Businesses - Education and Training Services - Financial Services - Healthcare and Wellness Providers - Hospitality Services - Human Resources and Recruiting - Legal Services - Manufacturing Companies - Non-profit Organizations - Pharmaceuticals and Biotech - Real Estate Agencies - Software and Technology Companies - Transportation and Logistics description: Business type for warmup context examples: - Software and Technology Companies x-apidog-orders: - workspace_id - ids - first_name - last_name - daily_limit - interval_limit_in_min - signature - clear_signature - reply_to - clear_reply_to - bulk_is_slow_rampup - bulk_rampup_daily_limit - bulk_rampup_daily_inc - warmup_custom_words - warmup_max_daily_limit - warmup_initial_daily_limit - warmup_pace_increment - warmup_signature - warmup_randomize - warmup_randomize_num - warmup_reply_rate - bulk_warmup_is_slow_rampup - warmup_schedule - warmup_business_type examples: comprehensive_example: value: workspace_id: 507f1f77bcf86cd799439011 ids: - 507f1f77bcf86cd799439012 - 507f1f77bcf86cd799439013 first_name: Sarah last_name: Johnson daily_limit: 150 interval_limit_in_min: 3 signature: Best regards,
John Doe bulk_is_slow_rampup: 'yes' bulk_rampup_daily_limit: 75 bulk_rampup_daily_inc: 15 warmup_custom_words: warmup-uniquness warmup_max_daily_limit: 40 warmup_initial_daily_limit: 8 warmup_pace_increment: 3 warmup_signature: 'yes' warmup_randomize: 'yes' warmup_randomize_num: 20 warmup_reply_rate: 0.3 bulk_warmup_is_slow_rampup: 'yes' warmup_schedule: tz: America/Los_Angeles from_time: '08:30' to_time: '18:00' days: - Monday - Tuesday - Wednesday - Thursday - Friday warmup_business_type: Software and Technology Companies summary: Comprehensive Example with All Fields description: Example showing all possible fields that can be updated basic_update: value: workspace_id: 507f1f77bcf86cd799439011 ids: - 507f1f77bcf86cd799439012 - 507f1f77bcf86cd799439013 first_name: Michael last_name: Chen daily_limit: 80 interval_limit_in_min: 4 summary: Basic Information Update description: Update basic account information and daily limits warmup_only: value: workspace_id: 507f1f77bcf86cd799439011 ids: - 507f1f77bcf86cd799439012 warmup_max_daily_limit: 25 warmup_custom_words: business, meeting, proposal, partnership warmup_reply_rate: 0.2 warmup_custom_domain: 'yes' warmup_signature: 'no' warmup_randomize: 'yes' warmup_randomize_num: 10 warmup_business_type: Digital Marketing Agencies summary: Warmup Configuration Only description: Configure only warmup-related settings rampup_configuration: value: workspace_id: 507f1f77bcf86cd799439011 ids: - 507f1f77bcf86cd799439014 - 507f1f77bcf86cd799439015 daily_limit: 200 bulk_is_slow_rampup: 'yes' bulk_rampup_daily_limit: 60 bulk_rampup_daily_inc: 20 bulk_warmup_is_slow_rampup: 'yes' warmup_max_daily_limit: 35 warmup_initial_daily_limit: 10 warmup_pace_increment: 5 summary: Rampup Settings description: Configure campaign and warmup rampup settings signature_and_reply: value: workspace_id: 507f1f77bcf86cd799439011 ids: - 507f1f77bcf86cd799439016 signature: |- Kind regards, Emily Rodriguez Customer Success Manager Innovate Solutions Direct: +1-555-123-7890 Email: emily.rodriguez@innovatesolutions.com reply_to: support@innovatesolutions.com summary: Signature and Reply-To Update description: Update email signatures and reply-to addresses clear_fields_example: value: workspace_id: 507f1f77bcf86cd799439011 ids: - 507f1f77bcf86cd799439017 clear_signature: 'yes' clear_reply_to: 'yes' summary: Clear Existing Fields description: Example of clearing signature and reply-to fields schedule_configuration: value: workspace_id: 507f1f77bcf86cd799439011 ids: - 507f1f77bcf86cd799439018 warmup_schedule: tz: Europe/London from_time: '09:30' to_time: '16:30' days: - Monday - Tuesday - Wednesday - Thursday - Friday - Saturday warmup_business_type: Financial Services summary: Advanced Schedule Configuration description: Configure detailed warmup schedule with timezone disable_features: value: workspace_id: 507f1f77bcf86cd799439011 ids: - 507f1f77bcf86cd799439019 disable_slow_rampup: 'yes' disable_slow_warmup_rampup: 'yes' summary: Disable Rampup Features description: Example of disabling slow rampup features responses: '200': description: Email accounts updated successfully content: application/json: schema: type: object properties: status: type: string description: Operation status examples: - success x-apidog-orders: - status headers: {} x-apidog-name: OK '400': description: Bad Request - Validation errors or invalid data content: application/json: schema: type: object properties: message: type: string description: Error message error: type: string description: Detailed error information errors: type: array items: type: string description: List of validation errors x-apidog-orders: - message - error - errors headers: {} x-apidog-name: Bad Request '401': description: Unauthorized - Invalid API key content: application/json: schema: type: object properties: message: type: string error: type: string x-apidog-orders: - message - error headers: {} x-apidog-name: Unauthorized '500': description: Internal Server Error content: application/json: schema: type: object properties: message: type: string error: type: string x-apidog-orders: - message - error headers: {} x-apidog-name: Server Error security: [] x-apidog-folder: Email Account x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/929054/apis/api-21391027-run components: schemas: {} securitySchemes: ApiKeyAuth: type: apikey in: header name: x-api-key description: | API key issued in the PlusVibe dashboard. The server reads it from the `x-api-key` header and injects it into the request as the `api_key` query parameter, which is why you will see `api_key` referenced in validation errors. apiKey: type: apikey in: body name: api_key description: API key passed in request body servers: - url: https://api.plusvibe.ai/api/v1 description: Prod Env security: - ApiKeyAuth: [] x-apidog: schemeGroups: - id: uS5KiuC4wfZHK42AzOfA_ schemeIds: - ApiKeyAuth required: true use: id: uS5KiuC4wfZHK42AzOfA_ scopes: uS5KiuC4wfZHK42AzOfA_: ApiKeyAuth: [] ```