POST

Mission.Create

Create a mission/task (same behavior as dashboard create_mission AJAX). Accepts App field names and dashboard aliases (message, client_id, organizations_user, appoinment_color1, time_mission, sub_missions, reminders, etc.). Runs mission.created automation and realtime mission.created. Existing simple calls with only mission + customer_id still work.

Permissions

  • User must be logged in with a valid bearer token.
  • Returned or changed records are limited by the user permissions, team access, folder access, and account settings.

Action

  • Creates a Mission record or sends the requested data after validation.

Push Service

Pushes event mission.created to users who should see this change.

Automation

Runs automation event mission.created with the record id and submitted parameters after the action succeeds.

Special Instructions

  • Send the bearer token on protected calls with Authorization: Bearer YOUR TOKEN.
  • Send parameters as POST body fields exactly as documented.
  • Send date/time values in UTC Y-m-d H:i:s format when a date or datetime field is used.

Required Parameters

NameTypeSampleExplanation
mission
post
stringCall customerMission title/text. Aliases: title, message (dashboard form field).

Optional Parameters

NameTypeSampleWhat it gives
note
post
stringFollow up about quoteOptional notes.
date_to_do
post
stringtomorrowDue date. Supports today, tomorrow, next_week, choose_date, or Y-m-d H:i:s / datetime. Alias: due_date. Default now.
days_after_ads
post
int3If set, due date = now + N days (dashboard days_after_ads).
customer_id
post
int123Customer id. Aliases: cust_id, client_id, clientid, client_id1, lead_id.
organizations_user
post
array|string47,48Assignee member id(s), comma-separated or array. Alias: member_id. Default current user.
project_id
post
int10Project id. If customer_id empty, customer may be taken from the project.
missions_steps_id
post
string5Mission step id from Create Mission Step dropdown (missions_steps). List options via Mission.StepsList / MissionSteps.List or User.Basic data.mission_steps. Or send add_new_mission_step with step_name_en / step_name_he / step_color. Alias: mission_step_id.
ticket_id
post
int900Linked ticket id.
project_column
post
stringto_doBoard column. Default to_do. If done and ticket_id set, ticket is marked done.
time_mission
post
string30minDuration. Alias: time. Also time_mission_days (Nd), time_mission_hours (Nh), or start_time+end_time.
priority
post
stringyellowCreate Mission Priority dropdown. Stored in missions.color. Values: transparent (Default), yellow, red, green, blue. Aliases: appoinment_color1 (dashboard select name), color. If omitted: yellow.
appoinment_color1
post
stringyellowDashboard form name for Priority. Same values as priority.
color
post
stringyellowAlias for Priority. Same values: transparent, yellow, red, green, blue.
tag_id
post
array|string1,2Tag ids. Aliases: tag, select_tag_misn, sel_tag.
repeat_days
post
stringdailyRepeat rule when used by the account (daily/weekly/monthly/etc.).
sub_missions
post
array|json["Check docs","Send email"]Sub-mission titles array, or JSON objects. Pair with sub_missions_done / sub_missions_done1 and sub_missions_user, or send sub_missions_formated.
mission_reminder
post
json[]Reminder JSON array, or parallel arrays reminder_name, reminder_description, reminder_type, reminder_send_on, reminder_datetime.
notify_client
post
int01 to notify customer.
email_me_employee
post
int01 to email assignees.
whatsApp_reminder
post
int01 for WhatsApp reminder. Alias: whatsapp_reminder.
use_as_template
post
int01 = save as template (show_mission becomes 0 unless show_mission is sent).
private_mission
post
int01 = private (clears assignees and customer, same as dashboard).
image
file
filephoto.pngMultipart image upload. Field names: image, image[], mission_image, mission_image[], file. Multiple files are joined with ---@---. Allowed image/document types same as Files.Upload. You can also send an already-uploaded path string in image / mission_image.
room_id
post
int0Optional room id.
flow_id
post
int0Optional workflow flow id.
step_id
post
int0Optional workflow step id.

Authentication

Send the bearer token returned by Login in the request header.

Authorization: Bearer YOUR TOKEN

Sample Request

{
    "url": "\/app\/Mission.Create",
    "method": "POST",
    "headers": {
        "Authorization": "Bearer YOUR TOKEN"
    },
    "body": {
        "mission": "Call customer",
        "customer_id": "123",
        "organizations_user": "47,48",
        "date_to_do": "tomorrow",
        "time_mission": "30min",
        "priority": "yellow",
        "project_id": "10",
        "missions_steps_id": "5",
        "note": "Follow up about quote",
        "notify_client": "0"
    },
    "url_user": "https:\/\/{user}.bull36.com\/app\/Mission.Create",
    "url_domain": "https:\/\/{domain}\/app\/Mission.Create"
}

Endpoint

POST /app/Mission.Create
POST https://{user}.bull36.com/app/Mission.Create
POST https://{domain}/app/Mission.Create

Sample Output

{
    "success": 1,
    "message": "Success",
    "mission_id": "500",
    "id": "500",
    "image": "biz1upload\/app\/{domain}\/{user}\/mission.add\/1784282338000-a1b2c3.png",
    "image_url": "https:\/\/files.biz1.co.il\/biz1upload\/app\/{domain}\/{user}\/mission.add\/1784282338000-a1b2c3.png",
    "images": [],
    "automation_event": "mission.created",
    "socket_event": "mission.created"
}

JavaScript Example

const token = 'YOUR TOKEN';
const body = new URLSearchParams({
  mission: 'Call customer',
  customer_id: '123',
  organizations_user: '47,48',
  date_to_do: 'tomorrow',
  time_mission: '30min',
  priority: 'yellow',
  note: 'Follow up about quote'
});
const res = await fetch('/app/Mission.Create', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + token },
  body
});
const data = await res.json();
console.log(data);

Error Example

{
    "success": 0,
    "message": "Missing required parameter: mission"
}