TourCMS, a leading online booking and channel management solution is operated by Palisis.

Contact Info

Palisis AG
Florastrasse 18A
8610 Uster
support@palisis.com
+41 44 533 40 40

Follow Us

home > support > API > Update agent profile information

Update Agent Profile

Update some details on an markeetplace agent

Notes

Designed to be used by agents only, not by tour operators.

REST info

Endpoint /api/agent/profile/update.xml
Formats XML
Example URL: /api/agent/profile/update.xml
 
POST data:
<?xml version="1.0"?>
<agent>
    <name>Name of agent</name>
    <short_description>A short description</short_description>
</agent>
Verb POST


 Code samples

PHP examples use the PHP Client Library with SimpleXML

Description

object update_agent_profile ( SimpleXmlElement $update_data)


Parameters

$update
SimpleXmlElement containing the agent data
$channel
ID number for the channel

Example



// Start building the agent XML
$agent_data = new SimpleXMLElement('<agent />');

// Must set the Agent ID on the XML, so TourCMS knows which to update
$agent_data->addChild('maid', '12345');

// Set the name
$agent_data->addChild('name', 'new name');

// Set the short description
$agent_data->addChild('short_description', 'new short description');

// Query the TourCMS API, updating the agent profile
$result = $tourcms->update_agent_profile($agent_data);

// Check the result, will be "OK" if the agent profile was updated
switch ($result->error) {
    case "OK":
    	// Print a success message
    	print "Agent profile updated.";
    	break;
    default:
    	// Some other problem (could check error to see what)
    	print "Sorry, unable to update agent profile.";
    	print $result->error;
    	break;
}
			

Agent updated.
			

C# examples use the .Net Client Library

Code sample here soon

VB examples use the .Net Client Library

Code sample here soon

NodeJS examples use the NodeJS Wrapper

Code sample here soon

Looking for sample code in a different language? TourCMS and community provided API libraries

Try it

Enter your TourCMS API credentials below to call the Tour Pickups Routes Update Pickup endpoint.

Take care, submitting this form will modify live data!


            
            


 Post fields

Post fields
XML Node Notes
agent

The root XML element

XML Node Notes
name Marketplace Agent Name
login_email Agent's email used to login
short_description Agent's description
contact_details Contact information
accounts_email Email used to communicate with other accounts or to send invoices
bookings_email Email used for automated new bookings communications
telephone Agent's phone number
fax Agent's Fax number
primary_name Name of the primary user of the agent account
primary_lastname Lastname of the primary user of the agent account
country 2 digit country code (uppercase). Here's a HTML snippet containing all countries in a select box
address Physical direction or postal code
website Website url
business_type Business type of the company. Possible values are:
  • arc
  • iata
  • clia
  • other
business_license_number Business license number
marketing_opt_in To mark the agent accessible to receive marketing communications. Values are 1 or 0.

 
Response fields

Response fields
XML Node Notes
request Confirmation of the request that you sent
error Any error message returned, if there is no error this will just contain the text OK.

More information