---
schema_version: "1"
id: 74e27fd9393d8c18e18ad76bc58e74ad564d045a74d902a57b8bcbc3d58de7fe
title: Post Data from an Amazon S3 Data Source
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/data-cloud-int/references/s3/c360-a-api-post-amazon-s3-data-stream.md
canonical_url: https://developer.salesforce.com/docs/data/data-cloud-int/references/data-cloud-s3-ref/c360-a-api-post-amazon-s3-data-stream.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 4967ec14e0572c35fa6944c9fd64978d9deaa9c93b2509c28477e9b54ee0b5c2
products:
  - Data 360 Integration Guide
  - Data 360 Developer Documentation
---
# Post Data from an Amazon S3 Data Source

Use the POST method to stream data from an Amazon S3 data source.

## Syntax

- HTTP method

  - : POST

- Availability

  - : Version 51.0 and later.

- Formats

  - : REST

- URI

  - : /services/data/\<vZZ.0>/ui-api/records

**note:** Substitute ZZ with the version of the API.

## Example

- URI

  - :

    ```nolang

             Post /services/data/v51.0/ui-api/records

    ```

- Request Body

  - :

    ```nolang

    {
      "apiName": "DataStream",
      "fields": {
        "Name": "{DATA STREAM NAME}",
        "DataStreamDefinitionId" : "{DATA STREAM DEFINITION ID}",
        "RefreshFrequency": "Hourly",
        "RefreshMode" : "Upsert"
      }
    }

    ```

- Request parameters

  - :
    | Parameter | Description |
    | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | apiName | Name of the entity that you’re creating. |
    | Name | The name of the data stream. |
    | DataStreamDefinitionId | The id of the data stream definition that must be associated with the data stream. This id must be available when you create the setup entities via metadata API CRUD or deploy. |
    | RefreshFrequency | _None, Hourly, Weekly_: You must provide the day of the week via: `RefreshDayOfWeek`. _Monthly_: You must provide the day of the month via: `RefreshDayOfMonth` |
    | RefreshMode | Upsert and Full_Refresh are supported. |

- Response

  - :

    ```nolang

    {
        "apiName": "DataStream",
        "childRelationships": {},
        "eTag": "9e9cb5c9a3e9db2e75918fa9b5b20815",
        "fields": {
            "CreatedBy": {
                "displayValue": "Admin User",
                "value": {
                    "apiName": "User",
                    "childRelationships": {},
                    "eTag": "8941f8da5501cf307f51e59c936e434b",
                    "fields": {
                        "Id": {
                            "displayValue": null,
                            "value": "005R0000000d9SfIAI"
                        },
                        "Name": {
                            "displayValue": null,
                            "value": "Admin User"
                        }
                    },
                    "id": "005R0000000d9SfIAI",
                    "lastModifiedById": "005R0000000d9SfIAI",
                    "lastModifiedDate": "2021-03-24T19:03:56.000Z",
                    "recordTypeId": null,
                    "recordTypeInfo": null,
                    "systemModstamp": "2021-03-31T22:47:39.000Z",
                    "weakEtag": 1617230859000
                }
            },
            "CreatedById": {
                "displayValue": null,
                "value": "005R0000000d9SfIAI"
            },
            "CreatedDate": {
                "displayValue": "4/2/2021, 2:50 PM",
                "value": "2021-04-02T21:50:23.000Z"
            },
            "DataStreamStatus": {
                "displayValue": "Processing",
                "value": "PROCESSING"
            },
            "ImportRunStatus": {
                "displayValue": "None",
                "value": "NONE"
            },
            "IsRefreshDeliveryHourAutomatic": {
                "displayValue": null,
                "value": false
            },
            "LastNumberOfRowsAddedCount": {
                "displayValue": null,
                "value": null
            },
            "LastRefreshDate": {
                "displayValue": null,
                "value": null
            },
            "Name": {
                "displayValue": null,
                "value": "s3-ui-api"
            },
            "RefreshDayOfMonth": {
                "displayValue": null,
                "value": null
            },
            "RefreshDayOfWeek": {
                "displayValue": null,
                "value": null
            },
            "RefreshFrequency": {
                "displayValue": "Hourly",
                "value": "HOURLY"
            },
            "RefreshHours": {
                "displayValue": null,
                "value": null
            },
            "RefreshMode": {
                "displayValue": "Upsert",
                "value": "UPSERT"
            },
            "TotalNumberOfRowsAdded": {
                "displayValue": null,
                "value": null
            },
            "TotalRowsProcessed": {
                "displayValue": null,
                "value": null
            }
        },
        "id": "1dsR000000002zzIAA",
        "lastModifiedById": "005R0000000d9SfIAI",
        "lastModifiedDate": "2021-04-02T21:50:23.000Z",
        "recordTypeId": "012000000000000AAA",
        "recordTypeInfo": null,
        "systemModstamp": "2021-04-02T21:50:23.000Z",
        "weakEtag": 1617400223000
    }

    ```