Teams - Create Team

In this article

Overview

You can use this Snap to perform the following operations:

  • Create a new team.

  • Create a new team from an existing group. 

Snap Type

Teams - Send Channel Message Snap is a Write-type Snap that creates a new private/public team either from scratch or from the existing group.

Prerequisites

None.

Support for Ultra Pipelines

Works in Ultra Pipelines

Limitations & Known Issues

None.

Snap Views

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input 

Document

  • Min: 0

  • Max: 1

  • Mapper Snap

  • Copy Snap

A document containing details of the team to create.

Output

Document

  • Min: 0

  • Max: 1

  • Mapper Snap

  • JSON Formatter + File Writer

A document containing details of the team created.

Error

Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter while running the Pipeline by choosing one of the following options from the When errors occur list under the Views tab:

  • Stop Pipeline Execution: Stops the current pipeline execution if the Snap encounters an error.

  • Discard Error Data and Continue: Ignores the error, discards that record, and continues with the remaining records.

  • Route Error Data to Error View: Routes the error data to an error view without stopping the Snap execution.

Learn more about Error handling in Pipelines.

Snap Settings

  • Asterisk (*): Indicates a mandatory field.

  • Suggestion icon (): Indicates a list that is dynamically populated based on the configuration.

  • Expression icon (): Indicates whether the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.

  • Add icon (): Indicates that you can add fields in the field set.

  • Remove icon (): Indicates that you can remove fields from the field set.

Field Name

Field Type

Field Dependency

Description

Field Name

Field Type

Field Dependency

Description

Label*

 

Default ValueCreate Team
Example: Create Marketing Team

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.

From Existing Group

 

Default Value: Deselected

Checkbox

Deactivates the Team Name, Team Description, Private Team, and Add Team Owners fields. Activates the Group ID field.

Select to create a team from an existing group.

 

Group ID

 

Default Value: N/A
Example: All Company : 12a345c6-78c9-0b1c-b2f3-ab45e678d980

String/Expression/Suggestion

Activates when you select the From Existing Group check box.

 

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

Team Name

 

Default Value: N/A
Example: Marketing Team

String/Expression

Activates when you deselect the From Existing Group check box.

 

Specify the name for the new team.

Team Description

 

Default Value: N/A
Example: Marketing team for the ABC Projects

String/Expression

Activates when you deselect the From Existing Group check box.

 

Specify a brief description about the new team.

Private Team

 

Default Value: Deselected

Checkbox

Activates when you deselect the From Existing Group check box.

Select this check box to create a private team.

Members in the organization cannot locate private teams through search. Only the owners of the private teams can invite them to join. Whereas, any member in the organization can locate and join public teams.

Add Team Owners

Fieldset

Activates when you deselect the From Existing Group check box. Use this field set to add owners for the team.

Use this fieldset to add one or more owners to the team.

Owner ID

 

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

String/Expression/Suggestion

N/A

Specify the ID of the member. Alternatively, click the  icon to fetch a list of member IDs within the organization. You can use each row to specify an owner or include all the owners in the same row separated by a comma.

Number of Retries

 

Default Value0
Example3

String/Expression

N/A

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

String/Expression

N/A

Specify the time interval in seconds between retry attempts.

Snap Execution

 

Default ValueExecute only
ExampleValidate &