# Move Contact Past Marketing Campaign Wait

Moves a contact past a skippable automation wait early. A scheduled action runs now or a timed condition is treated as met; following emails, SMS and tags may reach the contact early, without undo. Without confirm it previews, listing in immediateActions what the contact gets at once up to stopsAt; confirm only after the user agreed to this contact and automation. Requires administrator permission.

## Input schema:

```json
{
  "type": "object",
  "properties": {
    "contactId": {
      "type": "integer",
      "description": "Numeric contact ID returned by search-contacts",
      "minimum": 1
    },
    "automationId": {
      "type": "integer",
      "description": "Automation the contact waits in, from get-contact-automation-status",
      "minimum": 1
    },
    "referenceId": {
      "type": "integer",
      "description": "Reference of that position, from get-contact-automation-status; 0 for the contact-wide reference",
      "default": 0,
      "minimum": 0
    },
    "confirm": {
      "type": "boolean",
      "description": "false returns what would happen without writing; true ends the wait",
      "default": false
    },
    "accountId": {
      "type": [
        "null",
        "integer"
      ],
      "description": "User ID of the account; omit for the account of the access token",
      "default": null,
      "minimum": 1
    }
  },
  "required": [
    "contactId",
    "automationId"
  ],
  "additionalProperties": false
}
```

## Output schema:

```json
{
  "type": "object",
  "required": [
    "accountId",
    "contactId",
    "performed",
    "skipEffect",
    "nextActionId",
    "immediateActions",
    "stopsAt",
    "position",
    "historyUrl"
  ],
  "properties": {
    "accountId": {
      "type": "integer"
    },
    "contactId": {
      "type": "integer"
    },
    "performed": {
      "type": "boolean"
    },
    "skipEffect": {
      "type": "string",
      "enum": [
        "time-condition",
        "scheduled-wait"
      ]
    },
    "nextActionId": {
      "type": "integer"
    },
    "immediateActions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "actionId",
          "type",
          "name",
          "entityIds"
        ],
        "properties": {
          "actionId": {
            "type": "integer"
          },
          "type": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "entityIds": {
            "type": "array",
            "items": {
              "type": "integer"
            }
          }
        }
      }
    },
    "stopsAt": {
      "oneOf": [
        {
          "type": "object",
          "required": [
            "actionId",
            "type",
            "name",
            "entityIds"
          ],
          "properties": {
            "actionId": {
              "type": "integer"
            },
            "type": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "entityIds": {
              "type": "array",
              "items": {
                "type": "integer"
              }
            }
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "position": {
      "type": "object",
      "required": [
        "automationId",
        "automationName",
        "referenceId",
        "actionId",
        "actionType",
        "actionName",
        "state",
        "dueAt",
        "skippable",
        "skipEffect",
        "editUrl"
      ],
      "properties": {
        "automationId": {
          "type": "integer"
        },
        "automationName": {
          "type": "string"
        },
        "referenceId": {
          "type": "integer"
        },
        "actionId": {
          "type": "integer"
        },
        "actionType": {
          "type": "string"
        },
        "actionName": {
          "type": "string"
        },
        "state": {
          "type": "string",
          "enum": [
            "scheduled",
            "processing",
            "waiting-for-condition",
            "open-end",
            "waiting-for-restart",
            "waiting-for-time-condition",
            "enriching",
            "generating-email",
            "paused"
          ]
        },
        "dueAt": {
          "type": "string"
        },
        "skippable": {
          "type": "boolean"
        },
        "skipEffect": {
          "type": "string",
          "enum": [
            "",
            "time-condition",
            "scheduled-wait"
          ]
        },
        "editUrl": {
          "type": "string"
        }
      }
    },
    "historyUrl": {
      "type": "string"
    }
  }
}
```