Configuring Foursquare Accounts

On this Page

This account is used by the Snaps in the Foursquare Snap Pack.

You can create an account from Designer or Manager. In Designer, when working on pipelines, every Snap that needs an account prompts you to create a new account or use an existing account. The accounts can be created in or used from:

  • Your private project folder: This folder contains the pipelines that will use the account.
  • Your Project Space’s shared folder: This folder is accessible to all the users that belong to the Project Space.
  • The global shared folder: This folder is accessible to all the users within an organization in the SnapLogic instance.


Account Configuration

In Manager, you can navigate to the required folder and create an account in it (see Accounts). To create an account for Foursquare OAuth2: 

  1. Click Create, then select FourSquare > FourSquare OAuth2.
  2. Supply an account label.
  • For FourSquare OAuth2:
    • Click the Authorize bar. You will be asked to login into a FourSqaure account. Login with user credentials, after successfully login user will be asked to provide few steps for permissions.User has to allow permissions to make a connection.
    • (Optional) Supply additional information on this account in the Notes field of the Info tab.
    • Click Apply.
  • Click FourSquare Dynamic OAuth2.
    • Provide a valid access token to make requests agains OAuth2 enabled endpoints. The token can be a pipeline parameter.


Account Types

Foursquare Dynamic OAuth2

 Account Settings


Label


Required. User provided label for the account instance

Access token


Required. The access token for the application. The provided token will be passed as 'Authorization: bearer <access_token_value> to the snap if 'Header authenticated' property is enabled. Some endpoints require an uppercase letter for Bearer, then the property value for the token must be provided as 'Bearer <access_token_value>' for the access token property value. The access token is not refresh-able, but can be passed as a pipeline parameter. 

Account Encryption

Standard Encryption

If you are using Standard Encryption, the High sensitivity settings under Enhanced Encryption are followed.


Enhanced Encryption

If you have the Enhanced Account Encryption feature, the following describes which fields are encrypted for each sensitivity level selected for this account.

Account:

  • High: Access token
  • Medium + High: Access token
  • Low + Medium + High: Access token

Foursquare OAuth2

 Account Settings


Label


Required. User provided label for the account instance

Access token


Required. The access token for the application. The retrieval of the access token is done when setting up the account for the endpoint. There, the OAuth2 flow will be executed and the resulting access token will be stored in this property. The access token might be refreshable, in that case an optional refresh token can be stored. The user must get a new access token if the access token has expired and no refresh token was defined or both the access and the refresh token have expired.
Refresh tokenThe refresh token for the application. The retrieval of the refresh token is done when setting up the account for the endpoint. There, the OAuth2 flow will be executed and the resulting refresh token can be stored in this property. If the refresh token is stored, then the access token can be refreshed automatically before it expires.
Access token expirationThe access token expiration value.

OAuth2 Endpoint


Required. Authorization endpoint to authorize the application.

Default valuehttps://foursquare.com/oauth2/authenticate


OAuth2 Token


Required. Token endpoint to get the access token.

Default valuehttps://foursquare.com/oauth2/access_token


Auth endpoint config

Provides custom properties for the OAuth2 auth endpoint.


Application scope

The scope for the applications execution. As an example, the Snap could define that only a read of data by the application should be allowed.

Default value: [None]


Auto-refresh token

Refreshes the token automatically using the refresh token if the property is enabled. Otherwise the token might expire and will not be automatically refreshed.

Default value: Not selected

Authorize

Starts the OAuth authorization flow. Account will be saved before authorize.


Account Encryption

Standard Encryption

If you are using Standard Encryption, the High sensitivity settings under Enhanced Encryption are followed.


Enhanced Encryption

If you have the Enhanced Account Encryption feature, the following describes which fields are encrypted for each sensitivity level selected for this account.

Account:

  • High: Access token
  • Medium + High: Access token
  • Low + Medium + High: Access token

Snap Pack History

 Click to view/expand
ReleaseSnap Pack VersionDateTypeUpdates
4.27main12833 StableUpgraded with the latest SnapLogic Platform release.
4.26main11181 StableUpgraded with the latest SnapLogic Platform release.
4.25main9554StableUpgraded with the latest SnapLogic Platform release.
4.24main8556
 
Stable

Upgraded with the latest SnapLogic Platform release.

4.23main7430
 
StableUpgraded with the latest SnapLogic Platform release.
4.22main6403
 
StableUpgraded with the latest SnapLogic Platform release.
4.21snapsmrc542
 
StableUpgraded with the latest SnapLogic Platform release.
4.20snapsmrc535
 
StableUpgraded with the latest SnapLogic Platform release.
4.19snaprsmrc528
 
StableUpgraded with the latest SnapLogic Platform release.
4.18snapsmrc523
 
StableUpgraded with the latest SnapLogic Platform release.
4.17ALL7402
 
Latest

Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.

4.17snapsmrc515
 
Stable

Added the Snap Execution field to all Standard-mode Snaps. In some Snaps, this field replaces the existing Execute during preview check box.

4.16snapsmrc508
 
StableUpgraded with the latest SnapLogic Platform release.
4.15snapsmrc500
 
StableUpgraded with the latest SnapLogic Platform release.
4.14snapsmrc490
 
StableUpgraded with the latest SnapLogic Platform release.
4.13

snapsmrc486

 
Stable

Upgraded with the latest SnapLogic Platform release.

4.12

snapsmrc480

 
StableUpgraded with the latest SnapLogic Platform release.
4.11snapsmrc465
 
StableUpgraded with the latest SnapLogic Platform release.
4.10

snapsmrc414

 
StableUpgraded with the latest SnapLogic Platform release.
4.9

snapsmrc405

 
Stable

Upgraded with the latest SnapLogic Platform release.

4.8

snapsmrc398

 
StableUpgraded with the latest SnapLogic Platform release.
4.7

snapsmrc382

 
StableUpgraded with the latest SnapLogic Platform release.
4.6

rcmsf233

 
StableUpgraded with the latest SnapLogic Platform release.
4.5.1

rcmsf231

 
StableUpgraded with the latest SnapLogic Platform release.
4.5rcmsf231 Stable

Doc Enhancement: Example added to Foursquare Snap Pack.

January 2014NA

Initial release of this Snap Pack, with Get Lists, Get Tips, Recent Checkins, User Information, Venue Information, Venue Groups and Updates.