PROCESIO
OverviewPlatform ActionsIntegrations & DemosMarketplaceCustom ActionsDeveloperโ€™s Guide

Object Exists

Checks whether an object (file) exists in an Amazon S3 bucket.

Object Exists checks whether an object is in an Amazon S3 bucket and returns true or false. Use it before Get Object or Put Object to decide what the process does next.

Before you start

The AWS S3 actions don't use a stored credential. Each action has the same four connection fields:

FieldTypeRequiredWhat to put
Access KeyTextYesThe access key ID of an AWS IAM user, for example AKIAโ€ฆ.
Secret KeyTextYesThe secret access key that belongs to that access key.
RegionTextYesThe AWS region of the bucket, as its code, for example eu-central-1.
BucketTextYesThe bucket name, for example my-company-invoices.

The IAM user needs S3 permissions on the bucket for the operation you run. The values you type are visible to everyone who can edit the process, so prefer an IAM user limited to the buckets the process needs.

Add the action

In the Process Designer toolbox, open AWS S3 and pick Object Exists (or type Object Exists in the search box).

The Object Exists action properties: Access Key, Secret Key, Region, Bucket, Object Key and Result

Inputs and outputs

FieldDirectionTypeRequiredWhat to put / what you get
Access Key, Secret Key, Region, BucketInputTextYesThe connection fields described above.
Object KeyInputTextYesThe full key of the object, including every prefix, for example invoices/2026/inv-001.pdf.
ResultOutputBooleanYestrue if the object exists, false if it doesn't.

Example

Bucket my-company-invoices, Object Key invoices/2026/inv-001.pdf โ†’ Result true when that object is in the bucket, false otherwise.

Good to know

  • The key must be exact and complete: inv-001.pdf doesn't match invoices/2026/inv-001.pdf. Keys are case-sensitive.
  • A missing object returns false; it doesn't fail the step.
  • If a connection field is empty, the step fails with "Invalid connection details."
  • Common errors from S3: "Access forbidden! Ensure the connection details are valid." (wrong keys or missing permission), "Unable to connect! Ensure the provided region matches the bucket one." (wrong Region), and "Unrecognized Amazon Region: โ€ฆ" (a region code that doesn't exist).

On this page