Whitenow API Doc

White Now Job Advertisement Request API

The White Now Job Advertisement Request API allows approved partner organisations to submit job advertisement requests programmatically from their own systems.

Each request must include a valid Organisation Key in the request header. Submissions made with a valid Organisation Key bypass the standard payment flow. To obtain an Organisation Key, contact White Now via email at: info@whitenow.com.au.

---

Endpoint

POST https://testing.whitenow.com.au/wp-json/twxlabs/v1/job-ad-request

Authentication

Include your Organisation Key in the following HTTP header:

X-Organisation-Key: YOUR_ORGANISATION_KEY

Headers

Content-Type: application/json
X-Organisation-Key: YOUR_ORGANISATION_KEY

---

Example Request

{
    "title": "General Manager",
    "jobclass": "FullTime",
    "timeatwork": "Full-time role, Monday to Friday with occasional weekend commitments.",
    "clubname": "Example Club",
    "info": "<p>We are seeking an experienced General Manager to lead our venue.</p>",
    "staffben": "Supportive team, strong community presence and excellent facilities.",
    "contactname": "Jane Smith",
    "contactemail": "jane@exampleclub.com.au",
    "contactphone": "02 0000 0000",
    "contactmobile": "0400 000 000",
    "keepconf": "No",
    "seeksalary": "$120,000 - $140,000 plus super",
    "proofofadvert": "Yes",
    "yourname": "Jane Smith",
    "yourtitle": "HR Manager",
    "yourcompany": "Example Club",
    "yourcompanyaddress": "123 Example Street, Sydney NSW 2000",
    "youremail": "jane@exampleclub.com.au",
    "yourphone": "02 0000 0000",
    "jddoc": "https://www.exampleclub.com.au/files/job-description.pdf",
    "clublogo": "https://www.exampleclub.com.au/images/logo.png",
    "organisationapplylink": "www.exampleclub.com.au/jobs/apply/?id=123457"
}

---

Field Reference

Field	Required	Type	Notes
title	Yes	Text	Title of the position to be advertised. Maximum 100 characters.
jobclass	Yes	Option	Allowed values: FullTime, PartTime, PermPartTime, Casual, Contract.
timeatwork	No	Text	Hours and pattern of work. Maximum 255 characters.
clubname	No	Text	Name of club, company or venue. Maximum 100 characters.
info	No	HTML/Text	Main advertisement information. Safe HTML is allowed. Maximum 10,000 characters.
jddoc	No	URL	Publicly accessible URL to a job description document. Allowed file types: .docx, .pdf.
staffben	No	Text	Information about the role, club and community. Maximum 1,000 characters.
contactname	No	Text	Contact person for applications. Maximum 100 characters.
contactemail	No	Email	Email address for application/contact purposes.
contactphone	No	Text	Contact phone number. Maximum 50 characters.
contactmobile	No	Text	Contact mobile number. Maximum 50 characters.
keepconf	No	Option	Allowed values: Yes, No.
clublogo	No	URL	Publicly accessible URL to the club logo. Allowed file types: .jpg, .jpeg, .png.
seeksalary	No	Text	Approximate salary or hourly wage. Maximum 100 characters.
proofofadvert	No	Option	Allowed values: Yes, No.
yourname	No	Text	Name of the person submitting the request. Maximum 100 characters.
yourtitle	No	Text	Submitter title or position. Maximum 100 characters.
yourcompany	No	Text	Submitter company name. Maximum 100 characters.
yourcompanyaddress	No	Text	Submitter company address. Maximum 255 characters.
youremail	No	Email	Submitter email address.
yourphone	No	Text	Submitter phone number. Maximum 50 characters.
organisationapplylink	No	Text/URL	The Apply Now link applicants will click on the White Now Job Board for this Ad.

---

Successful Response

{
    "success": true,
    "message": "Job Ad request submitted successfully. White Now will be in touch with you soon.",
    "request_uuid": "f45c517e-0d25-46cd-accd-6019dd799481"
}

---

Error Responses

Missing Organisation Key

{
    "code": "missing_organisation_key",
    "message": "Missing X-Organisation-Key header.",
    "data": {
        "status": 401
    }
}

Invalid Organisation Key

{
    "code": "invalid_organisation_key",
    "message": "Invalid Organisation Key.",
    "data": {
        "status": 403
    }
}

Validation Error

{
    "code": "validation_failed",
    "message": "Validation failed.",
    "data": {
        "status": 422,
        "errors": {
            "jobclass": {
                "message": "Invalid option.",
                "provided": "Full-Time",
                "allowed_values": [
                    "FullTime",
                    "PartTime",
                    "PermPartTime",
                    "Casual",
                    "Contract"
                ]
            }
        }
    }
}

---

cURL Example

curl -X POST "https://testing.whitenow.com.au/wp-json/twxlabs/v1/job-ad-request" \
-H "Content-Type: application/json" \
-H "X-Organisation-Key: YOUR_ORGANISATION_KEY" \
-d '{
    "title": "General Manager",
    "jobclass": "FullTime",
    "clubname": "Example Club",
    "info": "<p>We are seeking an experienced General Manager.</p>",
    "contactname": "Jane Smith",
    "contactemail": "jane@exampleclub.com.au",
    "yourname": "Jane Smith",
    "youremail": "jane@exampleclub.com.au",
    "organisationapplylink":"https://yourclub.com.au/jobs/apply/?id=123457"
}'