---
schema_version: "1"
id: ce4550b3d235d07d720914cd9909fe78aa2459e45736c1894b5ca81f1667dde5
title: REST (Custom) Activity Format
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/rest.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/rest.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 4aa4e28bf14fad40a92fcd4a2a3e4a2f31d11f7068e305b0869fd6b0b4cd88b4
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# REST (Custom) Activity Format

You can use the REST activity to extend Journey Builder by posting requests to API endpoints.

## Helpful Hints

- The outcome of this decision affects goal statistics.
- API timeouts can impact the execution of this activity. For more information about limits that apply to Marketing Cloud Engagement APIs, see [API Limits and Guidelines](https://help.salesforce.com/s/articleView?id=mktg.mc_overview_limits_api.htm).
- If the `useJwt` property is set to true for any of the REST activity's methods, then a JWT for the account is generated, encoded, and sent as the POST body.
- If the `execute` method timeout is greater than the maximum allowed for the account, then use the maximum timeout value as configured in the account settings.

## Compatibility Information

This information is provided for developers upgrading their activities from the legacy format to the Journey Specification.

| 0.5 SerializedObject | 1.0 Serialized Object                      |
| -------------------- | ------------------------------------------ |
| execute.uri          | configurationArguments.url                 |
| execute.verb         | configurationArguments.method              |
| execute.body         | arguments.execute-body                     |
| execute.format       | (Not supported—the default format is JSON) |
| execute.useJwt       | configurationArguments.useJwt              |
| execute.timeout      | configurationArguments.timeout             |
| execute.inArguments  | arguments.executeInArguments               |
| execute.headers      | arguments.header                           |

## Sample Activity

```js
{
    "key": "rest-1",
    "name": "My Rest Activity",
    "type": "Rest",
    "metaData": {
        "flowDisplayName":"myFlow" // Displayed in the UI
    },
    "outcomes": [
        {
            "key": "rest-1-outcome-1",
            "next": "<key of next activity>"
        }
    ],
    "configurationArguments": {
        "save": {
            "url": "https://www.example.com/endpoint",
            "useJwt": false,
            "timeout": 3000,
            "headers": "https://www.example.com/endpoint",
            "body":"Hello"
        },
        "validate": {
            "url": "https://www.example.com/endpoint",
            "useJwt": false,
            "timeout": 3000,
            "headers": "https://www.example.com/endpoint",
            "body":"Hello"
        },
        "publish": {
            "url": "https://www.example.com/endpoint",
            "useJwt": false,
            "timeout": 3000,
            "headers": "https://www.example.com/endpoint",
            "body":"Hello"
        }
    },
    "arguments": {
        "execute": {
            "url": "https://www.example.com/endpoint",
            "headers": "",
            "inArguments": [{
                 "myArgument":""
             }],
            "body":"Hello . This field kept for backward compatibility.", // notice the Data Binding
            "method": "POST",
            "useJwt": true,
            "timeout": 3000
        }
    }
}
```

## Related Items

- [Custom Activities](https://developer.salesforce.com/docs/marketing/marketing-cloud/mc-app-development/creating-activities.md)
- [Encode Custom Activities Using a JWT](https://developer.salesforce.com/docs/marketing/marketing-cloud/mc-app-development/encode-custom-activities-using-jwt.md)
- [Journey Specification](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/getting-started-spec.md)