POST /rest/v1.0/project/{project_id}/email_communications/{communication_id}/emails

Creates a email on a given communication

Servers

Path parameters

Name Type Required Description
project_id Integer Yes

Unique identifier for the project.

communication_id Integer Yes

Communication ID

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Procore-Company-Id Integer Yes

Unique company identifier associated with the Procore User Account.

Query parameters

Name Type Required Description
topic_id Integer Yes

Topic ID

topic_type String Yes

The type of the topic to be associated with the communication

Possible values:

  • "change_event_event"
  • "project"
  • "prime_contract"
  • "direct_cost_item"
  • "purchase_order_contract"
  • "work_order_contract"
  • "payment_application"
  • "punch_item"
  • "form"
  • "generic_tool_item"
  • "task"
  • "daily_log_header"
  • "observation"
  • "submittal_log"
  • "meeting"
  • "checklist"
  • "incident"
  • "submittal_package"
  • "billings_requisition"
  • "rfi"

Request body fields

Name Type Required Description
email Object Yes
email.distribution_ids[] Array No

An array of IDs of the Distributions of the topic

email.file_version_ids[] Array No

File Versions to attach to the response

email.prostore_file_ids[] Array No

Prostore file IDs

email.bcc_distribution_ids[] Array No

User IDs on the email BCC distribution

email.form_ids[] Array No

Forms to attach to the response

email.image_ids[] Array No

Images to attach to the response

email.document_management_document_revision_ids[] Array No

PDM document to attach to the response

email.cc_distribution_ids[] Array No

User IDs on the email CC distribution

email.upload_ids[] Array No

Uploads to attach to the response

email.body String No

Body of the email

email.drawing_revision_ids[] Array No

Drawing Revisions to attach to the response

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.