Creating jobs from email form through API

You can now have Jobs created by new Clients outside of GeoOp, by adding a portal to your businesses webpage.

Important Note: This portal must be created by your own IT staff and cannot be created for you by GeoOp.

It is intended for use as a Job request tool for new clients only, as requests through this system will create a new Client in GeoOp. For businesses requiring existing Client job requests you have 2 options:

  • Using the GeoOp API. This requires a broader IT competency to implement. If you are interested, you can find the GeoOp API documentation here.
  • Providing Client access to your account. This is a relatively new feature by which you can provide select Clients access to your account in much the same way one of your Staff members. They can then be enabled to create Jobs on their account. For further details please read our article here.

Implementing GeoOp Email to Job

The process for creating this system is as follows:

  1. Firstly provide this information to your IT staff to check they are capable of implementing the system as required.  It will be your responsibility to ensure field and format control to provide clean data that GeoOp can read.
  2. Each account has a unique email address to send job emails to. This must be requested from the GeoOp Support Team, by clicking here. It will be returned to you in the format
  3. Create your web portal using the fields chosen from the below list. Some fields are required as a basic minimum to create a Job and a Client. All other fields are optional. See the table for further details.

Note: All field values in the email should be formatted like [FIELDNAME:VALUE] – a set of dummy completed fields can be found below the table.

Note: Attachments to the email will be added as file notes on the Job.

Note: Job request emails that are unsuccessful will be picked up and a notification of the failure will be sent to your account owner’s email address. Troubleshooting failed emails with your Clients will be your responsibility.

Note: The email key is case sensitive. It must follow the format

Fields supported by the email form


GeoOp target field


Details / format requirements


Job Title




Job Ref


Should be a unique job reference. If left blank, will auto generate a generic unique reference on creation


Order Number




Job Start (date)


Should be format 30 Jan 2000, else may read incorrectly


Job Start (hour)


Range 0–23


Job Start (min)


Range 0–59


Job End (date)


Should be format 30 Jan 2000, else may read incorrectly


Job End (hour)


Range 0–23


Job End (min)


Range 0–59




Range 1–3 (tallies with low, normal, urgent options)


Address 1


Building number & street/road only


Address 2








Job Description


Free text – eg extra Job details, specific requirements, further location info (building, door, floor etc)


First Name




Last Name


* Either Last Name or Company is required, not necessarily both




* Either Last Name or Company is required, not necessarily both






Physical Add 1


Building number & street/road only


Physical Add 2




Physical City








Mobile Number




Mobile Country Code


Country code for mobile phone. Number format only, no spaces










Mailing Add 1




Mailing Add 2




Mailing City




Business Type







Sample email data

Below is a full set of sample data as it could be sent to your unique email address:





[TIMEENDDATE:22 Nov 2012]




[TITLE: Email to Job1!]

[DESCRIPTION:A job and client created from an e-mail]

[ADDRESS:123 Imaginary Street]

[SUBURB:Fake Valley]

[CITY:Fake City]



[CLIENT_COMPANY: Jamie's Plumbing Co]



[CLIENT_ADDRESS:1 Tautari Street]



[CLIENT_PHONE:09 623 677]

[CLIENT_MOBILE:021 020 2020]


[CLIENT_FAX:09 623 678]




[CLIENT_NOTES:these are notes]


Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request


Powered by Zendesk