---
schema_version: "1"
id: bdd026c6c7d529ea2d0982c56c5a2b7b5304e1ef929ae1dd5025605b7b7c3cb0
title: Goals
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/goals.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/goals.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 356251d6a554735fb61925bd9893cc52d7f700ee58840875be28246645b9f72f
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# Goals

The goal object is used to measure the effectiveness of an associated journey. Goals are only evaluated via their criteria or filter XML.

## Journey Specification Format

The activity must be formatted as specified below. The following JSON object will be included in the `goals` array of a journey, as defined in the Journey Specification.

## Helpful Hints

- When a journey is saved, each goal is saved.
- Goals are evaluated every 24 hours and upon exiting each wait activity.
- The `metaData.conversionUnit` property is a string that can be either "percentage" or "wholenumber".
- The `metaData.conversionValue` property is a number as a string.
- The `configurationArguments.criteria` property is an XML string that defines a filter that is used as a data-gate to determine if a contact qualifies for this goal.

## Sample Request

```js
{
    "goals": [
        {
            "key": "user-defined-key",
            "name": "name of your goal",
            "description": "The description of this goal",
            "type": "Event",
            "outcomes": [],
            "arguments": {},
            "configurationArguments": {
                "criteria": "<FilterDefinition><ConditionSet Operator=\"AND\" ConditionSetName=\"Individual Filter Grouping\"><Condition Key=\"bulkevent_de.Locale\" Operator=\"Equal\"><Value><![CDATA[asdf]]></Value></Condition></ConditionSet></FilterDefinition>",
                "schemaVersionId": 122
            },
            "metaData": {
                "conversionValue": "1",
                "conversionUnit": "wholenumber",
                "conversionTypeId": 1,
                "isExitCriteria": true,
                "eventDefinitionKey": "My-Event-Key",
                "eventDefinitionId": "<guid>"
            }
        }
    ]
}
```

## Sample Response

```js
{
    "goals": [
        {
            "id": "SFMC-provided-GUID",
            "key": "user-defined-key",
            "name": "name of your goal",
            "description": "The description of this goal",
            "type": "ContactEvent",
            "outcomes": [],
            "arguments": {},
            "configurationArguments": {
                "criteria": "<FilterDefinition><ConditionSet Operator=\"AND\" ConditionSetName=\"Individual Filter Grouping\"><Condition Key=\"bulkevent_de.Locale\" Operator=\"Equal\"><Value><![CDATA[asdf]]></Value></Condition></ConditionSet></FilterDefinition>",
                "schemaVersionId": 122
            },
            "metaData": {
                "conversionValue": "1",
                "conversionUnit": "wholenumber",
                "conversionTypeId": 1,
                "isExitCriteria": true,
                "eventDefinitionKey": "My-Event-Key",
                "eventDefinitionId": "<guid>"
            }
        }
    ]
}
```

## Related Items

[Journey Specification](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/getting-started-spec.md)