---
title: "Related Data: Record Added (S)"
slug: "related-data-record-added-s"
updated: 2024-03-07T08:19:57Z
published: 2024-03-07T08:19:57Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Related Data: Record Added (S)

This event executes a job when a single record is added to a related data set with the API method **​relatedDataCreateRecord.​**

> WARNING!
> 
> This event cannot be used to execute (C) jobs that affect individual contacts. For this purpose, use [Related Data: User-Specific Record Added (C](/v1/docs/related-data-user-specific-record-added-c))

> Hint:
> 
> In Mapp Engage, the designation ​(S)​ means system-related. Generally, you only combine ​system (S) events​ with ​system (S) jobs​. For more information, see [​Contact (C) vs. System (S) Automations​](/v1/docs/contact-c-vs-system-s-automations)

## General

| ​Name​ | Defines the name of the automation. The name is used to identify the automation in the system. The maximum length is 100 characters. |
| --- | --- |
| ​Description​ | Provides information about the automation. The description makes it easier to identify the automation in the system. |
| ​Event​ | Selects the type of event that, when combined with a job, forms the automation. Every time this event occurs, the system executes the dependent job. The job is defined in the ​[**Edit Event-based Job​**](/v1/docs/edit-event-window) window. |

## Define Event​

This area defines the specific parameters of the event.

- **Related Data Set:** This drop-down field defines the related data set to which the record is added.
- **Related Data Key:** These fields limit the event to records added to a specific related data key. When blank, the event includes all records added with any key.
  - **Equals:** The related data key exactly matches the value in the input field.
  - **Does Not Equal:** The related data key does not match the value in the input field.
  - **Starts with:** The related data key starts with the value in the input field.
  - **Ends with:** The related data key ends with the value in the input field.
  - **Matches [Regex]:** The related data key matches the regular expression in the input field.
- **Case Insensitive:** This checkbox ignores differences in uppercase and lowercase.
- **Success:** This drop-down field limits the event to a successful or unsuccessful addition. When blank, both successful and unsuccessful attempts to add a related data record initiate the job.
  - **Yes:** The job is only initiated if the related data record was successfully addded.
  - **No:** The job is only initiated if the related data record was not successfully addded.
- **Parameters:** These fields are not appropriate for this event.

## Actions

The following actions are available:

- **Edit Job​:** This button saves the changes and opens the [**Edit Event-Based Job**window**​**](/v1/docs/edit-event-based-job-window).