Amazon S3

Note: In order to use the Amazon S3 integration, you must create the S3 bucket in which you want to store your data. You’ll also need to provide Foursquare with write access to the bucket in order to start receiving data.


We do this through role-based authentication, where you apply a policy to the S3 bucket that grants Foursquare list, read and write permissions.\

Integration Details

  1. Create an S3 Bucket. The bucket name must begin with 4sq-partner-pilgrimsdk.
  2. Create a new Bucket Policy from the template below and be sure to replace {bucket} with the name of the S3 bucket created in Step 1.
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "s3:ListBucket"
      ],
      "Effect": "Allow",
      "Resource": "arn:aws:s3:::4sq-partner-pilgrimsdk-{bucket}",
      "Principal": {
        "AWS": [
          "arn:aws:iam::628804397842:role/4sq-s3-team-pilgrimsdk"
        ]
      }
    },
    {
      "Action": [
        "s3:PutObject",
        "s3:PutObjectAcl",
        "s3:GetObject",
        "s3:GetObjectAcl",
        "s3:DeleteObject"
      ],
      "Effect": "Allow",
      "Resource": "arn:aws:s3:::4sq-partner-pilgrimsdk-{bucket}/*",
      "Principal": {
        "AWS": [
          "arn:aws:iam::628804397842:role/4sq-s3-team-pilgrimsdk"
        ]
      }
    }
  ]
}
  1. Apply the policy to the bucket.
  2. Make sure the Pilgrim SDK is properly setup.
  3. From your Foursquare Pilgrim Console, Enable Third Party Integrations .
  4. If the policy is set up correctly, the bucket will be validated and saved; we will begin delivering visit and geofence events to your bucket daily.
  5. Check out the schema for Geofence Data Schema .

Did this page help you?