Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Field Name

Field Type

Field Dependency

Description

Label*

Default ValueChannel Operations
Example: Channel Operations

String

N/A

Specify a unique name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.

Operation*

Default ValueAdd Members
Example: Rename Channel

String

N/A

Select the channel operation to perform.  Available options include:

  • Add Members: Activates the Team ID field, and Add Team Owners and Add Members field sets. 

  • Remove Members: Activates the Team ID field and Remove Members field sets.

  • List Members: Activates the Team ID field.

  • List Teams: Deactivates all fields except for the Snap Execution field. 

  • List Channels: Activates the Team ID field. Deactivates the remaining fields except for the Snap Execution field. 

  • Rename Team: Activates the Team ID and New Team Name fields.

  • Delete Team: Activates the Team ID field. 

  • Archive Team: Activates the Team ID field.

  • Unarchive Team: Activates the Team ID field.

Team ID*

Default Value: N/A
Example: b22e8da4-17c1-45c0-baa9-47aed7344e92

String/Expression/Suggestion

Activates when you select the Add Members, Remove Members, List Members, List Channels, Rename Team, Delete Team, Archive Team, and Unarchive Team options in the Operation field.

Specify the ID of the team. Alternatively, click the  icon to fetch a list of team IDs associated with the account. 

Add Members

Use this fieldset to add members to the channel.

Member ID

Default Value: N/A
Example: e12b3456-7c89-012b-345f-67c89dca0bcd

String/Expression/Suggestion

Activates when you select the Add Members option in the Operation field.

Specify the ID of the member to add. Alternatively, click the  icon to fetch a list of member IDs in the organization. You can use each row to specify a member or include multiple members separated by commas, in the same row.

Add Team Owners

Use this fieldset to add owners for the team. 

Owner ID

Default Value: N/A
Example: e12b3456-7c89-012b-345f-67c89dca0bcd

String/Expression/Suggestion

Activates when you select the Add Members option in the Operation field.

Specify the ID of the member. Alternatively, click the  icon to fetch a list of member IDs associated with the team. You can use each row to specify an owner or include multiple owners separated by commas, in the same row.

Remove Members

Use this fieldset to remove members from the channel. The Snap shows an error message if the member does not exist in the team.

Member ID

Default Value: N/A
Example: e12b3456-7c89-012b-345f-67c89dca0bcd

String/Expression/Suggestion

Activates when you select the Remove Members option in the Operation field.

Specify the ID of the team member to remove. Alternatively, click the  icon to fetch a list of member IDs associated with the team. You can use each row to specify a member or include all the members in the same row separated by a comma.

New Team Name

Default Value: N/A
Example: New_Contractors

String/Expression

Activates when you select the Rename Team option in the Operation field.

Specify a new name for the selected team.

Number of Retries

Default Value0
Example3

Integer/Expression

Activates when you select the Add Members, Remove Members, Rename Team, Delete Team, Archive Team, or Unarchive Team option in the Operation field.

Specify the number of attempts the Snap makes to perform the selected operation in case of connection failure/unsuccessful attempts. 

To avoid 502 Bad Gateway error

Use a higher value (such as 3, 4, or more) in this field to ensure the Snap/Pipeline runs successfully. 

Retry Interval (seconds)

Default Value1
Example6

Integer/Expression

Activates when you select the Add Members, Remove Members, Rename Team, Delete Team, Archive Team, or Unarchive Team option in the Operation field (Retries are NOT available for listing operations - List Members, List Teams, and List Channels).

Specify the time interval in seconds between retry attempts.

To avoid 502 Bad Gateway error

Use a higher value (such as 3, 4, or more) in this field to ensure the Snap/Pipeline runs successfully. 

Snap Execution

Default ValueExecute only
ExampleValidate & Execute

Dropdown list

N/A

Select one of the three following modes in which the Snap executes:

  • Validate & Execute. Performs limited execution of the Snap and generates a data preview during Pipeline validation, then performs full execution of the Snap (unlimited records) during Pipeline runtime.

  • Execute only. Performs full execution of the Snap during Pipeline execution without generating preview data.

  • Disabled. Disables the Snap and all Snaps downstream from it.

Troubleshooting

Error 

Reason 

Resolution

API returned error in Archive Team operation

The Snap request failed with 500. This typically indicates a server-side issue or an unexpected problem with the service.

Make sure the Snap settings are configured properly or reauthorize the account with valid values.

400 - Bad Request. Error in creating a channel.

The request to create the channel was invalid. 

Team ID needs to be a valid GUID

401 - Invalid Authentication Token

The provided authentication token is either expired, invalid, or does not have the necessary permissions to access this resource.

Ensure that you provide valid access token.

...