To start taking advantage of the data in your reference sets, you must connect them to your audience and — if necessary — to each other.

You can connect the audience to a reference set that is connected to another reference set. Unlike the audience, reference sets support only one-level connections.

Connections are established based on a common attribute. The source and destination attributes must be of the same type (for example, text/text or date/date). To learn more about the options, see our marketing guide - Create connections.

To establish any of these connections, use the addReferenceSetAssociation object.

mutation {
  addReferenceSetAssociation(
    dataSetAssociation: {
      to: "b4fc145e-680a-4fc6-9d7a-00000000001"
      from: "a7c170d2-51d5-4c86-9a28-000000au1"
      mappings: { toAttribute: "ID", fromAttribute: "Unique ID" }
    }
  ) {
    to {
      dataSetId
      name
    }
    from {
      dataSetId 
      name 
    }
  }
}

{
  "data": {
    "addReferenceSetAssociation": {
      "to": {
        "dataSetId": "b4fc145e-680a-4fc6-9d7a-00000000001",
        "name": "Focus group participants"
      },
      "from": {
        "dataSetId": "a7c170d2-51d5-4c86-9a28-000000au1",
        "name": "Green store"
      }
    }
  }
}

Arguments

Arguments supported by the addReferenceSetAssociation mutation

Fields

Fields returned by the addReferenceSetAssociation mutation