Skip to main content
Altcraft Docs LogoAltcraft Docs Logo
User guideDeveloper guideAdmin guide
Company siteHelp center
English
  • Русский
  • English
v74
  • v74
  • v73
  • v72
Login
  • Getting Started
  • Administrator documentation
  • Functional characteristics
  • Technology description
  • System requirements
  • Admin Panel
  • Platform installation
  • Platform configuration
  • Platform maintenance
  • Custom channels guide
  • Extra
  • Processing HTTP/HTTPS traffic
  • Administrator API
    • Accounts admin api
    • Account users
    • Nodes
    • Senders admin api
    • Virtual senders
      • Get virtual senders list
      • Get virtual sender information
      • Create virtual sender
      • Update virtual sender
      • Clone virtual sender
      • Delete virtual sender
  • Administrator API
  • Virtual senders
  • Update virtual sender
Documentation for version v74

Update virtual sender

Description​

Updates an existent virtual sender configuration.

Request URL​

Method: POST

https://example.com/api/v1.1/vsenders/update

Request parameters​

ParameterTypeExampleRequiredDescription
tokenstring"abcdefghijklmnqrstuvwxyz"YesAPI token
formatstring"json"NoResponse data format
By default – json
account_idint306YesAccount ID
idint12345YesVirtual sender ID
namestring"New virtual sender"YesVirtual sender name
email_rulesJSON-object
YesRules for email senders
sms_rulesJSON-object
YesRules for SMS senders

Request example​

  • JSON
  • XML
    
{
"token": "abcdefghijklmnqrstuvwxyz",
"name": "Virtual sender",
"account_id": 3,
"id": 14,
"sms_rules": [],
"email_rules": [
{
"senders": [
{
"from_email": "",
"from_name": "",
"percent": 100,
"replyto_email": "",
"sender_id": 3
}
],
"type": "default",
"value": ""
}
]
}
<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
<name>Virtual sender</name>
<account_id>3</account_id>
<id>14</id>
<sms_rules/>
<email_rules>
<senders>
<from_email></from_email>
<from_name></from_name>
<percent>100</percent>
<replyto_email></replyto_email>
<sender_id>3</sender_id>
</senders>
<type>default</type>
<value></value>
</email_rules>
</xml>

Response example​

  • JSON
  • XML
{
"data": {
"saved_id": 14
},
"error": 0,
"error_text": "Successful operation"
}
<xml>
<data>
<saved_id>14</saved_id>
</data>
<error>0</error>
<error_text>Successful operation</error_text>
</xml>

Response parameters​

ParameterTypeDescription
errorintError code
error_textstringError text
Last updated on Mar 16, 2024
Previous
Create virtual sender
Next
Clone virtual sender
  • Description
  • Request URL
  • Request parameters
  • Request example
  • Response example
  • Response parameters
© 2015 - 2025 Altcraft, LLC. All rights reserved.