Interests Test
CRM/Interests/CreateOrUpdate
Creates, updates, or deletes interests passed as a collection. We recommend that this resource be used for making multiple edits to Constituent Interests in a single API request. Interests that exist will be updated with provided Weight and Selected values. If an existing interest is provided with a Weight of 0 or NULL and a Selected: false, the interest will be deleted. New Interests should be created with an Id of -999 (or NULL).
Http Verb POST
Resource URL https://ts-stg-appgw.calacademy.org/TessituraService/CRM/Interests/CreateOrUpdate

URI Parameters

This resource has no URI (Query) parameters.

Request Body

Request object type : Collection of Interest

Request object type Collection of Interest has the following properties.
Property Name Data Type Length Required Readonly Notes
Constituent Entity Y Constituent that the Interest is associated.
CreatedBy string N Auto-assigned
CreatedDateTime date N Auto-assigned
CreateLocation string N Auto-assigned
EditIndicator boolean N readonly Whether this interest is editable based on control group permission.
Id integer N Auto-assigned
InterestType InterestTypeSummary Y Type of the interest. Only one entity of this type may be created per constituent.
FK: TR_TKW.id   Resource: InterestTypes
Selected boolean N Typically indicates a selection that the constituent has made.
UpdatedBy string N Auto-assigned
UpdatedDateTime date N Auto-assigned
Weight integer N A value weighting the constituent's association to this interest type, complementing or in opposition to their indicated selections. 
[
  {
    "InterestType": {
      "Description": "sample string 1",
      "Id": 1,
      "UsedIn": "sample string 2",
      "Category": {
        "Description": "sample string 1",
        "Id": 1
      },
      "ControlGroup": {
        "Description": "sample string 1",
        "Id": 2,
        "Inactive": true
      }
    },
    "Constituent": {
      "Id": 1
    },
    "CreatedDateTime": "2025-04-24T04:54:33.133396-07:00",
    "CreateLocation": "sample string 1",
    "CreatedBy": "sample string 2",
    "Id": 1,
    "UpdatedDateTime": "2025-04-24T04:54:33.133396-07:00",
    "UpdatedBy": "sample string 3",
    "Selected": true,
    "Weight": 1,
    "EditIndicator": true
  },
  {
    "InterestType": {
      "Description": "sample string 1",
      "Id": 1,
      "UsedIn": "sample string 2",
      "Category": {
        "Description": "sample string 1",
        "Id": 1
      },
      "ControlGroup": {
        "Description": "sample string 1",
        "Id": 2,
        "Inactive": true
      }
    },
    "Constituent": {
      "Id": 1
    },
    "CreatedDateTime": "2025-04-24T04:54:33.133396-07:00",
    "CreateLocation": "sample string 1",
    "CreatedBy": "sample string 2",
    "Id": 1,
    "UpdatedDateTime": "2025-04-24T04:54:33.133396-07:00",
    "UpdatedBy": "sample string 3",
    "Selected": true,
    "Weight": 1,
    "EditIndicator": true
  }
]
<Interests xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Interest>
    <Constituent>
      <Id>1</Id>
    </Constituent>
    <CreateLocation>sample string 1</CreateLocation>
    <CreatedBy>sample string 2</CreatedBy>
    <CreatedDateTime>2025-04-24T04:54:33.133396-07:00</CreatedDateTime>
    <EditIndicator>true</EditIndicator>
    <Id>1</Id>
    <InterestType>
      <Category>
        <Description>sample string 1</Description>
        <Id>1</Id>
      </Category>
      <ControlGroup>
        <Description>sample string 1</Description>
        <Id>2</Id>
        <Inactive>true</Inactive>
      </ControlGroup>
      <Description>sample string 1</Description>
      <Id>1</Id>
      <UsedIn>sample string 2</UsedIn>
    </InterestType>
    <Selected>true</Selected>
    <UpdatedBy>sample string 3</UpdatedBy>
    <UpdatedDateTime>2025-04-24T04:54:33.133396-07:00</UpdatedDateTime>
    <Weight>1</Weight>
  </Interest>
  <Interest>
    <Constituent>
      <Id>1</Id>
    </Constituent>
    <CreateLocation>sample string 1</CreateLocation>
    <CreatedBy>sample string 2</CreatedBy>
    <CreatedDateTime>2025-04-24T04:54:33.133396-07:00</CreatedDateTime>
    <EditIndicator>true</EditIndicator>
    <Id>1</Id>
    <InterestType>
      <Category>
        <Description>sample string 1</Description>
        <Id>1</Id>
      </Category>
      <ControlGroup>
        <Description>sample string 1</Description>
        <Id>2</Id>
        <Inactive>true</Inactive>
      </ControlGroup>
      <Description>sample string 1</Description>
      <Id>1</Id>
      <UsedIn>sample string 2</UsedIn>
    </InterestType>
    <Selected>true</Selected>
    <UpdatedBy>sample string 3</UpdatedBy>
    <UpdatedDateTime>2025-04-24T04:54:33.133396-07:00</UpdatedDateTime>
    <Weight>1</Weight>
  </Interest>
</Interests>

Response object type : Collection of Interest

Response object type Collection of Interest has the following properties.
Property Name Data Type Length Required Readonly Notes
Constituent Entity Y Constituent that the Interest is associated.
CreatedBy string N Auto-assigned
CreatedDateTime date N Auto-assigned
CreateLocation string N Auto-assigned
EditIndicator boolean N readonly Whether this interest is editable based on control group permission.
Id integer N Auto-assigned
InterestType InterestTypeSummary Y Type of the interest. Only one entity of this type may be created per constituent.
FK: TR_TKW.id   Resource: InterestTypes
Selected boolean N Typically indicates a selection that the constituent has made.
UpdatedBy string N Auto-assigned
UpdatedDateTime date N Auto-assigned
Weight integer N A value weighting the constituent's association to this interest type, complementing or in opposition to their indicated selections. 
[
  {
    "InterestType": {
      "Description": "sample string 1",
      "Id": 1,
      "UsedIn": "sample string 2",
      "Category": {
        "Description": "sample string 1",
        "Id": 1
      },
      "ControlGroup": {
        "Description": "sample string 1",
        "Id": 2,
        "Inactive": true
      }
    },
    "Constituent": {
      "Id": 1
    },
    "CreatedDateTime": "2025-04-24T04:54:33.1489835-07:00",
    "CreateLocation": "sample string 1",
    "CreatedBy": "sample string 2",
    "Id": 1,
    "UpdatedDateTime": "2025-04-24T04:54:33.1489835-07:00",
    "UpdatedBy": "sample string 3",
    "Selected": true,
    "Weight": 1,
    "EditIndicator": true
  },
  {
    "InterestType": {
      "Description": "sample string 1",
      "Id": 1,
      "UsedIn": "sample string 2",
      "Category": {
        "Description": "sample string 1",
        "Id": 1
      },
      "ControlGroup": {
        "Description": "sample string 1",
        "Id": 2,
        "Inactive": true
      }
    },
    "Constituent": {
      "Id": 1
    },
    "CreatedDateTime": "2025-04-24T04:54:33.1489835-07:00",
    "CreateLocation": "sample string 1",
    "CreatedBy": "sample string 2",
    "Id": 1,
    "UpdatedDateTime": "2025-04-24T04:54:33.1489835-07:00",
    "UpdatedBy": "sample string 3",
    "Selected": true,
    "Weight": 1,
    "EditIndicator": true
  }
]
<Interests xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Interest>
    <Constituent>
      <Id>1</Id>
    </Constituent>
    <CreateLocation>sample string 1</CreateLocation>
    <CreatedBy>sample string 2</CreatedBy>
    <CreatedDateTime>2025-04-24T04:54:33.1489835-07:00</CreatedDateTime>
    <EditIndicator>true</EditIndicator>
    <Id>1</Id>
    <InterestType>
      <Category>
        <Description>sample string 1</Description>
        <Id>1</Id>
      </Category>
      <ControlGroup>
        <Description>sample string 1</Description>
        <Id>2</Id>
        <Inactive>true</Inactive>
      </ControlGroup>
      <Description>sample string 1</Description>
      <Id>1</Id>
      <UsedIn>sample string 2</UsedIn>
    </InterestType>
    <Selected>true</Selected>
    <UpdatedBy>sample string 3</UpdatedBy>
    <UpdatedDateTime>2025-04-24T04:54:33.1489835-07:00</UpdatedDateTime>
    <Weight>1</Weight>
  </Interest>
  <Interest>
    <Constituent>
      <Id>1</Id>
    </Constituent>
    <CreateLocation>sample string 1</CreateLocation>
    <CreatedBy>sample string 2</CreatedBy>
    <CreatedDateTime>2025-04-24T04:54:33.1489835-07:00</CreatedDateTime>
    <EditIndicator>true</EditIndicator>
    <Id>1</Id>
    <InterestType>
      <Category>
        <Description>sample string 1</Description>
        <Id>1</Id>
      </Category>
      <ControlGroup>
        <Description>sample string 1</Description>
        <Id>2</Id>
        <Inactive>true</Inactive>
      </ControlGroup>
      <Description>sample string 1</Description>
      <Id>1</Id>
      <UsedIn>sample string 2</UsedIn>
    </InterestType>
    <Selected>true</Selected>
    <UpdatedBy>sample string 3</UpdatedBy>
    <UpdatedDateTime>2025-04-24T04:54:33.1489835-07:00</UpdatedDateTime>
    <Weight>1</Weight>
  </Interest>
</Interests>
Change Version Description Contract Old New
Operation Added 15.1.0 CreateOrUpdate has been added. CreateOrUpdate