---
schema_version: "1"
id: 86e3c3b25d7c353b233947b3a2861dab028295760ca36b58add874649bfc0f75
title: POST /interaction/v1/interactions
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/postCreateInteraction.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_interaction/postCreateInteraction.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: ab0ab32d58fdc32f06c3e3181891dd09e3291fd643d17bd8488cb9829569c4a9
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# POST /interaction/v1/interactions

## Overview

Creates or saves a journey. To create a new journey provide the request body in the appropriate [Journey Specification](https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_interaction/getting-started-spec.md). Please read the Journey Spec page to understand which properties are required to create a journey via the API. The **id**, **key**, **createdDate**, **modifiedDate**, **status** and **definitionId** are assigned by Journey Builder and are never to be passed in as parameters for creating a journey. To call this resource, assign your API Integration the Automation | Interactions | Read scope.

### JSON Parameters

<!--complex table-->

| Name                   | Type   |              | Description                                                                                                        |
| ---------------------- | ------ | ------------ | ------------------------------------------------------------------------------------------------------------------ |
| **key**                | string | **Required** | The customer key as a GUID (UUID) to be used while referencing this journey                                        |
| **name**               | string | **Required** | The name of this journey                                                                                           |
| **description**        | string |              | A description of this journey                                                                                      |
| **workflowApiVersion** | number | **Required** | The Journey Spec version to use for this journey. Possible values: 0.5, 1.0.                                       |
| **goals**              | array  |              | The goal for this particular journey. Expressed as an object of type ContactDecision from the Journey Spec.        |
| **triggers**           | array  |              | The trigger for this particular journey. Expressed as an object of type ContactEvent from the Journey Spec.        |
| **activities**         | array  |              | The activities which compose this particular journey. Expressed as objects of types supported by the Journey Spec. |

### Usage

**Example Request**

This request creates a journey. This example represents the minimum required parameters to create a journey, as prescribed by the [Journey Spec](https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_interaction/getting-started-spec.md). These JSON paramters are always provided by Journey Builder and can never be supplied:

- id
- lastPublishedDate
- createdDate
- modifiedDate
- definitionId

To understand how to leverage the full capability of creating journeys via the API, the Journey Spec documentation provides a comprehensive list of all available paramters. This enables you to create multiple combinations of entry events, waits, data-binding, activities and outcomes for a journey.

```js
Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
POST /interaction/v1/interactions
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

{
    "key": "ixn-created-via-the-api",
    "name": "API-Created journey",
    "workflowApiVersion": 1.0 ,
    "triggers": [],
    "goals": [],
    "activities": []
}
```

**Example Response**

```js
HTTP/1.1 200
{
    id: "unique-UUID-provided-by-SFMC"
    key: "ixn-created-via-the-api"
    name: "API-Created journey"
    lastPublishedDate: "0001-01-01T00:00:00"
    description: ""
    workflowApiVersion: 1
    createdDate: "2014-08-06T23:27:08.15"
    modifiedDate: "2014-08-06T23:27:08.15"
    triggers:[]
    goals:[]
    activities:[]
    status: "Draft"
    definitionId: "unique-UUID-provided-by-SFMC"
}
```