cURL request formatting
Depending on the command line tool you use, the format in which you use cURL to make API requests will differ. See your command line tool below for the cURL syntax to use when making requests to Oracle Eloqua's APIs.
Bash
When using bash command line, format your cURL requests according to the following guidelines.
| cURL option | Syntax | Example |
|---|---|---|
| --user | "<instanceName>\<userName>" | "APITest\API.User" |
| --data | '{"<key>":"<value>"}' | '{"emailAddress":"george.washington@america.com"}' |
Syntax
curl --user "<instanceName>\<userName>" --header "Content-Type: application/json" --request POST --data '{"<key>":"<value>"}' https://secure.p0<podNumber>.eloqua.com/api/<apiType>/<apiVersion>/<endpoint>
Example
curl --user "APITest\API.User" --header "Content-Type: application/json" --request POST --data '{"emailAddress":"george.washington@america.com"}' https://secure.p03.eloqua.com/api/REST/1.0/data/contact
Windows command line
When using Windows command line, format your cURL requests according to the following guidelines. Note that JSON must be serialized differently in windows command line compared to other command lines.
| cURL option | Syntax | Example |
|---|---|---|
| --user | "<instanceName>\<userName>" | "APITest\API.User" |
| --data | "{\"<key>\":\"<value>\"}" | "{\"emailAddress\":\"george.washington@america.com\"}" |
Syntax
curl --user "<instanceName>\<userName>" --header "Content-Type: application/json" --request POST --data "{\"<key>\":\"<value>\"}" https://secure.p0<podNumber>.eloqua.com/api/<apiType>/<apiVersion>/<endpoint>
Example
curl --user "APITest\API.User" --header "Content-Type: application/json" --request POST --data "{\"emailAddress\":\"george.washington@america.com\"}" https://secure.p03.eloqua.com/api/REST/1.0/data/contact
Terminal (macOS)
When using terminal, format your cURL requests according to the following guidelines.
| cURL option | Syntax | Example |
|---|---|---|
| --user | "<instanceName>\\<userName>" | "APITest\\API.User" |
| --data | '{"<key>":"<value>"}' | '{"emailAddress":"george.washington@america.com"}' |
Syntax
curl --user "<instanceName>\\<userName>" --header "Content-Type: application/json" --request POST --data '{"<key>":"<value>"}' https://secure.p0<podNumber>.eloqua.com/api/<apiType>/<apiVersion>/<endpoint>
Example
curl --user "APITest\\API.User" --header "Content-Type: application/json" --request POST --data '{"emailAddress":"george.washington@america.com"}' https://secure.p03.eloqua.com/api/REST/1.0/data/contact