---
title: "Put Record Step"
slug: "put-record-step"
updated: 2025-08-19T19:57:00Z
published: 2025-08-19T19:57:00Z
canonical: "documentation.decisions.com/put-record-step"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Put Record Step

| Step Details |
| --- |
| **Introduced in Version** | 4.0.0 |
| **Last Modified in Version** | 8.9.0 |
| **Location** | Integration > Kinesis > Put Record Step |

The **Put Record** step allows individual messages to be added to an AWS Kinesis data stream.

### Prerequisites

- This step requires the [Amazon AWS Module](https://documentation.decisions.com/docs/aws) to be [installed](https://documentation.decisions.com/docs/installing-modules-decisions) before it will be available in the toolbox, and an active [AWS account](https://signin.aws.amazon.com/signin?redirect_uri=https%3A%2F%2Fconsole.aws.amazon.com%2Fconsole%2Fhome%3FhashArgs%3D%2523%26isauthcode%3Dtrue%26nc2%3Dh_ct%26src%3Dheader-signin%26state%3DhashArgsFromTB_eu-north-1_c1412528899e4833&client_id=arn%3Aaws%3Asignin%3A%3A%3Aconsole%2Fcanvas&forceMobileApp=0&code_challenge=HQku5BPrRUboP5p1wGr4Ai_nBIQNSqsR2eHJNCBfxhQ&code_challenge_method=SHA-256). The [Amazon WebServices Settings](https://documentation.decisions.com/docs/setting-up-amazon-webservices-integration) must also be configured.
- For v9 users, a [dependency](https://documentation.decisions.com/docs/project-dependencies) must be created after installing the module in order for the the steps to be properly used.

---

## Properties

#### Inputs

| Property | Description | Data Type |
| --- | --- | --- |
| Data | List of Byte Data that will be passed as a record to the stream. | List of Byte |
| Hash Key | Optional string representing the hash key. | String |
| Partition Key | A Unicode string representing the partition key. This is used to group data by shard within a stream and can be a maximum of 256 characters. | String |
| Region | The region the data stream resides in. This can be found in the ARN for the data stream. | AmazonAWSRegion |
| Sequence Number | Optional string used for the sequence number. The sequence number is unique for each partition key within a shard, and will increase each time the partition key is used. | String |
| Stream Name | The name of the data stream. | String |

#### Outputs

| Property | Description | Data Type |
| --- | --- | --- |
| Done |  |  |
|  | Output | Outputs shared resulting shard Id | String |

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-08-05_14h28_47.png)

---

## Example Inputs and Outputs

| Data | Partition Key | Region | Stream Name | Output |
| --- | --- | --- | --- | --- |
| SGVsbG8slFRoaXMgaXMgYSB0ZXN0IHN0cmluZw | 123456 | us-east-1 | Testing | shardid-000000000002 |

---

## Common Errors

### The Security Token Included in the Request is Invalid

If the token inputted is expired or not declared, the step will cause an error. To correct this, ensure you are using a token that is active.

#### Exception Message:

```csharp
DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Put Record Step 1[PutRecordStep] in flow [Dynamo Steps Flow]: Exception invoking method PutRecordStep on class KinesisSteps
 ---> DecisionsFramework.LoggedException: Exception invoking method PutRecordStep on class KinesisSteps
 ---> Amazon.Kinesis.AmazonKinesisException: The security token included in the request is invalid.
 ---> Amazon.Runtime.Internal.HttpErrorResponseException: Exception of type 'Amazon.Runtime.Internal.HttpErrorResponseException' was thrown. at Amazon.Runtime.HttpWebRequestMessage.ProcessHttpResponseMessage(HttpResponseMessage responseMessage)
 at Amazon.Runtime.HttpWebRequestMessage.GetResponseAsync(CancellationToken cancellationToken)
 at Amazon.Runtime.Internal.HttpHandler`1.InvokeAsync[T](IExecutionContext executionContext)
 at Amazon.Runtime.Internal.Unmarshaller.InvokeAsync[T](IExecutionContext executionContext)
 at Amazon.Runtime.Internal.ErrorHandler.InvokeAsync[T](IExecutionContext executionContext)
   --- End of inner exception stack trace ---
```

---

Related Information

Related Article:

[https://documentation.decisions.com/docs/about-aws-kinesis](https://documentation.decisions.com/docs/about-aws-kinesis)