Add Project

Overview
Creates a Project in MobiWork

URL Format
https://{domain}/api/rest/{clientId}/{versionNumber}/project/add.html?token=XXXXXXXX&userId={userId}

Arguments

clientId required	MobiWork assigned unique ID of the company
versionNumber required	Version number of MobiWork API SDK release. Current version is: 10.0.78
token required	Part of URL as a request parameter and is required in every call to verify access to API calls
userId optional	If provided, this User ID will be taken as a logged in user. If not provided we use an active global administrator ID

Return
Returns a Project Object if creation was successful. Returns an error if it was not a valid request

Request Body XSD

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
  <xs:element name="request">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="project"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="project">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="customerName"/>
        <xs:element ref="customerId"/>
        <xs:element ref="customStatus"/>
        <xs:element ref="categoryName"/>
        <xs:element ref="projectName"/>
        <xs:element ref="description"/>
        <xs:element ref="projectManager"/>
        <xs:element ref="externalId"/>
        <xs:element ref="location"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="customerName" type="xs:string"/>
  <xs:element name="customerId" type="xs:integer"/>
  <xs:element name="customStatus" type="xs:NCName" minOccurs="0"/>
  <xs:element name="categoryName" type="xs:string" minOccurs="0"/>
  <xs:element name="projectName" type="xs:string"/>
  <xs:element name="description" type="xs:string" minOccurs="0"/>
  <xs:element name="projectManager" type="xs:integer" minOccurs="0"/>
  <xs:element name="externalId" type="xs:string" minOccurs="0">
    <xs:complexType/>
  </xs:element>
  <xs:element name="location">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="address1"/>
        <xs:element ref="address2"/>
        <xs:element ref="city"/>
        <xs:element ref="state"/>
        <xs:element ref="zipCode"/>
        <xs:element ref="countryId"/>
        <xs:element ref="latitude"/>
        <xs:element ref="longitude"/>
        <xs:element ref="name"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="address1" type="xs:string"/>
  <xs:element name="address2" type="xs:string" minOccurs="0"/>
  <xs:element name="city" type="xs:string" minOccurs="0"/>
  <xs:element name="state" type="xs:NCName" minOccurs="0"/>
  <xs:element name="zipCode" type="xs:integer" minOccurs="0"/>
  <xs:element name="countryId" type="xs:integer" minOccurs="0"/>
  <xs:element name="latitude" type="xs:decimal" minOccurs="0"/>
  <xs:element name="longitude" type="xs:decimal" minOccurs="0"/>
  <xs:element name="name" type="xs:string" minOccurs="0"/>
</xs:schema>

Response Body XSD

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
  <xs:element name="response">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="project"/>
      </xs:sequence>
      <xs:attribute name="statusCode" use="required" type="xs:integer"/>
      <xs:attribute name="version" use="required" type="xs:NMTOKEN"/>
    </xs:complexType>
  </xs:element>
  <xs:element name="project">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="projectId"/>
        <xs:element ref="customerId"/>
        <xs:element ref="addressId"/>
        <xs:element ref="description"/>
        <xs:element ref="assignedTo"/>
        <xs:element ref="minNumberOfUsers"/>
        <xs:element ref="maxNumberOfUsers"/>
        <xs:element ref="minNumberOfUsersInCrew"/>
        <xs:element ref="maxNumberOfUsersInCrew"/>
        <xs:element ref="minNumberOfCrews"/>
        <xs:element ref="maxNumberOfCrews"/>
        <xs:element ref="shippingAddressId"/>
        <xs:element ref="externalId"/>
        <xs:element ref="crewList"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="projectId" type="xs:integer"/>
  <xs:element name="customerId" type="xs:integer"/>
  <xs:element name="addressId" type="xs:integer"/>
  <xs:element name="description" type="xs:string"/>
  <xs:element name="assignedTo" type="xs:integer"/>
  <xs:element name="minNumberOfUsers" type="xs:integer"/>
  <xs:element name="maxNumberOfUsers" type="xs:integer"/>
  <xs:element name="minNumberOfUsersInCrew" type="xs:integer"/>
  <xs:element name="maxNumberOfUsersInCrew" type="xs:integer"/>
  <xs:element name="minNumberOfCrews" type="xs:integer"/>
  <xs:element name="maxNumberOfCrews" type="xs:integer"/>
  <xs:element name="shippingAddressId" type="xs:integer"/>
  <xs:element name="externalId">
    <xs:complexType/>
  </xs:element>
  <xs:element name="crewList">
    <xs:complexType/>
  </xs:element>
</xs:schema>

Curl Example

HTTP Method:	POST
Request:	curl -k -X POST 'https://www.mobiwork.com/api/rest/17800/10.0.80/project/add.html?token=HQS7J32UJ31OPRZMZWGB' \ --header 'Content-Type: application/xml' \ --data-raw '<request> <project> <customerName>Another User Test Company 8462</customerName> <customerId>3473387</customerId> <customStatus>CustomProjectStatus</customStatus> <categoryName>New Project Category Test</categoryName> <projectName>New Project Name</projectName> <description>Testing Add Project</description> <projectManager>84330</projectManager> <externalId></externalId> <location> <address1>160 Congress Park Dr</address1> <address2>Ste 205</address2> <city>Delray Beach</city> <state>FL</state> <zipCode>33432</zipCode> <countryId>1</countryId> <latitude>49.25779</latitude> <longitude>6.20195</longitude> <name>US Random Address</name> </location> </project> </request>'
Response:	<?xml version="1.0" encoding="UTF-8" ?> <response version="10.0.80" statusCode="1"> <project> <projectId>2188</projectId> <customerId>3473387</customerId> <addressId>4925989</addressId> <description>Testing Add Project</description> <assignedTo>84330</assignedTo> <minNumberOfUsers>0</minNumberOfUsers> <maxNumberOfUsers>0</maxNumberOfUsers> <minNumberOfUsersInCrew>0</minNumberOfUsersInCrew> <maxNumberOfUsersInCrew>0</maxNumberOfUsersInCrew> <minNumberOfCrews>0</minNumberOfCrews> <maxNumberOfCrews>0</maxNumberOfCrews> <shippingAddressId>0</shippingAddressId> <externalId></externalId> <crewList></crewList> </project> </response>