---
title: "Create New Job"
slug: "api-create-new-job"
updated: 2020-06-04T14:07:30Z
published: 2020-06-04T14:07:31Z
canonical: "help.cenpoint.com/api-create-new-job"
excludeFromSearch: true
excludeFromExternalSearch: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.cenpoint.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create New Job

Create New Job

Type

- Post

Example:

- URL: [https://ws.cenpoint.com/cpwc.wc?custcode=bogusCustCode&token=bogusToken&appName=sweetAppName&prg=cpapi&proc=createNewJob](https://ws.cenpoint.com/cpwc.wc?custcode=bogusCustCode&token=bogusToken&appName=sweetAppName&prg=cpapi&proc=createJobReqAlert)
- Body: custId=0000000043&tsDate=2020-06-03T00:00:00&workDesc=Scan and core 28 holes... rest of desc... contact Scott for questions&siteContFName=Scott&siteContLName=CenPoint&addr1=13134 S 5800 W&city=Herriman&state=UT

Base URL (includes authentication + end point)

- https://ws.cenpoint.com/cpwc.wc?custcode=<<Company Code>>&token=<<API Key>>&appName=<<YourAppName>>&prg=cpapi&proc=createNewJob

Body Parameters (Required): (please see [Escaping Body Parameters](https://help.cenpoint.com/v1/docs/api-escaping-body-parameters))

- | Name | Type | Description | Example |
| --- | --- | --- | --- |
| custId | String | The 10 character custId to tie this job to | 0000000043 |
| tsDate | Date (or String) | The tentative start date for the job. Can be passed either as a date (time will be ignored) or as a string with MM/DD/YYYY formatting | 2020-06-03T00:00:00 or 06/03/2020 |
| workDesc | String | Description of work to be performed. No length limit | Scan and core 28 holes... rest of desc... contact Scott for questions |
| siteContFName | String | First name of the site contact. Max of 15 characters | Scott |
| siteContLName | String | Last name of the site contact. Max of 25 characters | CenPoint |

Body Parameters (Optional):

- | Name | Type | Description | Example |
| --- | --- | --- | --- |
| addr1 | String | First line of the job address. Max length of 35 characters | 131314 S. 5800 W. |
| addr2 | String | Second line of the job address. Max length of 35 characters. | Suite 204 |
| city | String | City of the job address. Max length of 25 characters | Herriman |
| state | String | State abbreviation of the job address. Max length of 2 characters | UT |
| zip | String | Zip code of the job address. Max length of 10 characters | 84096 |
| po | String | Job PO (if applicable). Max of 20 characters | 12345678910 |
| jobTitle | String | Job Title / Desc. Max of 35 characters | Walmart Job |
| siteContCell | String | Cell phone of the site contact. Only used if contact doesn't already exist. Formatting will be stripped away. Max of 10 characters | 8014786822 |

Returns:

- Array of with the newly created jobsId
  - {"VFPData":{"rows":[{"jobsid":"0000000021"}]}}
  - Returned Fields:

| Name | Type | Description | Example |
| --- | --- | --- | --- |
| jobsid | String | 10 character id for the job that was created | 0000000021 |
- or Error Msg Object
  - {"errorCode":"-4","errorDesc":"CustId 0000000273 does not exist or is not available at the requested branch. Try creating a job request alert instead."}
    - Customer does not exist or is not available at the branch you authenticated with.
    - A user with access to CenPoint must open the customer -> Branch Availability -> Check the desired branch
  - {"errorCode":"-5","errorDesc":"New job alert department is not set up under branch settings"}
    - A user with access to CenPoint must go to File -> Company / Branch Info -> Pick Branch and Modify -> Misc. Tab -> Specify the 'New Job Alert' Department