# Post a job to CannaMatch Instructions: https://www.cannamatch.xyz/agents OpenAPI: https://www.cannamatch.xyz/openapi.json Browser form: https://www.cannamatch.xyz/post 1. Only submit a job the user has asked you to post. Read the live original posting and collect the fields below; ask for missing facts and the employer's hiring email. Do not invent pay, requirements, vacancies or contact details. 2. Send one JSON request to POST https://www.cannamatch.xyz/api/jobs with Content-Type: application/json. No account or API key is needed. Replace every example value with the user's real job details; omit optional fields you do not know. 3. A normal accepted submission returns HTTP 201 with a job id and pending: true. Save the id and tell the user the posting is awaiting human review. Acceptance is not publication; the public detail page can return 404 while held. The employer receives confirmation and a private edit link by email. Keep edit links private. 4. For HTTP 400, read the error and correct the supplied details. If it says Bot check failed, use the /post browser form and let the user complete any challenge. Do not bypass bot checks. If the platform cannot send HTTP requests, use that same form. 5. For HTTP 429, respect Retry-After (seconds). The limit is three valid submissions per hour per IP, including shared platform IPs. Do not rotate IPs or resubmit in a loop. A timeout or server error can leave submission status uncertain: report that uncertainty instead of retrying blindly. This endpoint does not provide idempotent retries. 6. Posting is free. Every new submission is reviewed by a human and expires 30 days after submission unless renewed. Candidates apply through the original job URL. Return the job id and review status to the user, and only call it live after it is publicly visible. ## Fields All values are strings. Text fields are trimmed. Send only documented fields. - title (required): Job title, 1–200 characters. - company (required): Employer name, 1–200 characters. - description (required): Plain-text job description, 50–15,000 characters. Use the actual posting's details. - url (required): Live application or original posting URL, including http:// or https://, up to 2,048 characters. - state (required): Two-letter US state code. Our focus is MA, CT, RI, NH, VT and ME. For remote roles, ask which state to list. - contactEmail (required): Employer-authorized hiring email, up to 254 characters. Used for confirmation, private edit links, match summaries and renewal reminders; excluded from public job listings. - location (optional): City and state or an accurate remote location, up to 120 characters. - workMode (optional): remote, hybrid or onsite. - jobType (optional): full-time, part-time or contract. ## Example Replace ALL example values before submitting. Save your JSON as job.json. ```json { "title": "Cannabis Retail Associate", "company": "Example Cannabis Company", "location": "Worcester, MA", "state": "MA", "description": "Help customers understand cannabis products, maintain accurate inventory, and follow state retail regulations. See the original posting for full requirements and application instructions.", "url": "https://example.com/careers/retail-associate", "contactEmail": "hiring@example.test", "workMode": "onsite", "jobType": "full-time" } ``` ```sh curl --request POST 'https://www.cannamatch.xyz/api/jobs' \ --header 'Content-Type: application/json' \ --data @job.json ``` Expected acceptance: HTTP 201, {"id":"","pending":true}. Errors return JSON {"error":""}. Never treat a 201 alone as proof of publication or email delivery. Help with an uncertain submission: hello@cannamatch.xyz.