Create a Open Enrollment Member Request
curl --request POST \
--url https://fulfillment.noyo.com/api/v1/employees/{employee_id}/member_requests/open_enrollment \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"coverages": [
{
"carrier_config": {},
"carrier_id": "9a0a7437-4097-4251-9e71-85384c0eb1c9",
"created": 1557512389,
"lines_of_coverage": {
"medical": {
"adding_coverage": [
{
"id": "fd62665c-0846-4e9d-bd29-80779b5f685c",
"member_type": "dependent",
"plan_id": "b988cd26-121a-4dd6-b0be-09399f6ecc0a"
}
]
}
},
"modified": 1564440756,
"signature_date": "2022-01-15"
}
]
}
'import requests
url = "https://fulfillment.noyo.com/api/v1/employees/{employee_id}/member_requests/open_enrollment"
payload = { "coverages": [
{
"carrier_config": {},
"carrier_id": "9a0a7437-4097-4251-9e71-85384c0eb1c9",
"created": 1557512389,
"lines_of_coverage": { "medical": { "adding_coverage": [
{
"id": "fd62665c-0846-4e9d-bd29-80779b5f685c",
"member_type": "dependent",
"plan_id": "b988cd26-121a-4dd6-b0be-09399f6ecc0a"
}
] } },
"modified": 1564440756,
"signature_date": "2022-01-15"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
coverages: [
{
carrier_config: {},
carrier_id: '9a0a7437-4097-4251-9e71-85384c0eb1c9',
created: 1557512389,
lines_of_coverage: {
medical: {
adding_coverage: [
{
id: 'fd62665c-0846-4e9d-bd29-80779b5f685c',
member_type: 'dependent',
plan_id: 'b988cd26-121a-4dd6-b0be-09399f6ecc0a'
}
]
}
},
modified: 1564440756,
signature_date: '2022-01-15'
}
]
})
};
fetch('https://fulfillment.noyo.com/api/v1/employees/{employee_id}/member_requests/open_enrollment', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://fulfillment.noyo.com/api/v1/employees/{employee_id}/member_requests/open_enrollment",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'coverages' => [
[
'carrier_config' => [
],
'carrier_id' => '9a0a7437-4097-4251-9e71-85384c0eb1c9',
'created' => 1557512389,
'lines_of_coverage' => [
'medical' => [
'adding_coverage' => [
[
'id' => 'fd62665c-0846-4e9d-bd29-80779b5f685c',
'member_type' => 'dependent',
'plan_id' => 'b988cd26-121a-4dd6-b0be-09399f6ecc0a'
]
]
]
],
'modified' => 1564440756,
'signature_date' => '2022-01-15'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://fulfillment.noyo.com/api/v1/employees/{employee_id}/member_requests/open_enrollment"
payload := strings.NewReader("{\n \"coverages\": [\n {\n \"carrier_config\": {},\n \"carrier_id\": \"9a0a7437-4097-4251-9e71-85384c0eb1c9\",\n \"created\": 1557512389,\n \"lines_of_coverage\": {\n \"medical\": {\n \"adding_coverage\": [\n {\n \"id\": \"fd62665c-0846-4e9d-bd29-80779b5f685c\",\n \"member_type\": \"dependent\",\n \"plan_id\": \"b988cd26-121a-4dd6-b0be-09399f6ecc0a\"\n }\n ]\n }\n },\n \"modified\": 1564440756,\n \"signature_date\": \"2022-01-15\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://fulfillment.noyo.com/api/v1/employees/{employee_id}/member_requests/open_enrollment")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"coverages\": [\n {\n \"carrier_config\": {},\n \"carrier_id\": \"9a0a7437-4097-4251-9e71-85384c0eb1c9\",\n \"created\": 1557512389,\n \"lines_of_coverage\": {\n \"medical\": {\n \"adding_coverage\": [\n {\n \"id\": \"fd62665c-0846-4e9d-bd29-80779b5f685c\",\n \"member_type\": \"dependent\",\n \"plan_id\": \"b988cd26-121a-4dd6-b0be-09399f6ecc0a\"\n }\n ]\n }\n },\n \"modified\": 1564440756,\n \"signature_date\": \"2022-01-15\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://fulfillment.noyo.com/api/v1/employees/{employee_id}/member_requests/open_enrollment")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"coverages\": [\n {\n \"carrier_config\": {},\n \"carrier_id\": \"9a0a7437-4097-4251-9e71-85384c0eb1c9\",\n \"created\": 1557512389,\n \"lines_of_coverage\": {\n \"medical\": {\n \"adding_coverage\": [\n {\n \"id\": \"fd62665c-0846-4e9d-bd29-80779b5f685c\",\n \"member_type\": \"dependent\",\n \"plan_id\": \"b988cd26-121a-4dd6-b0be-09399f6ecc0a\"\n }\n ]\n }\n },\n \"modified\": 1564440756,\n \"signature_date\": \"2022-01-15\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"body": {
"coverages": [
{
"carrier_config": {},
"carrier_id": "9a0a7437-4097-4251-9e71-85384c0eb1c9",
"lines_of_coverage": {
"medical": {
"adding_coverage": [
{
"id": "fd62665c-0846-4e9d-bd29-80779b5f685c",
"member_type": "dependent",
"plan_id": "b988cd26-121a-4dd6-b0be-09399f6ecc0a"
}
]
}
},
"signature_date": "2022-01-15"
}
]
},
"employee_id": "30b74a44-d5b1-4123-a7a4-6d3aec251ba4",
"id": "f4517b87-275a-42e1-85e5-47ea6ab5312b",
"request_type": "open_enrollment",
"status": "processing",
"transactions": [
"579952dd-9a66-4587-a4f7-72a63bf9ec86"
]
}Requests
Create a Open Enrollment Member Request
The open enrollment member request is used to make changes to existing employees, dependents and coverages during the open enrollment period.
POST
/
api
/
v1
/
employees
/
{employee_id}
/
member_requests
/
open_enrollment
Create a Open Enrollment Member Request
curl --request POST \
--url https://fulfillment.noyo.com/api/v1/employees/{employee_id}/member_requests/open_enrollment \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"coverages": [
{
"carrier_config": {},
"carrier_id": "9a0a7437-4097-4251-9e71-85384c0eb1c9",
"created": 1557512389,
"lines_of_coverage": {
"medical": {
"adding_coverage": [
{
"id": "fd62665c-0846-4e9d-bd29-80779b5f685c",
"member_type": "dependent",
"plan_id": "b988cd26-121a-4dd6-b0be-09399f6ecc0a"
}
]
}
},
"modified": 1564440756,
"signature_date": "2022-01-15"
}
]
}
'import requests
url = "https://fulfillment.noyo.com/api/v1/employees/{employee_id}/member_requests/open_enrollment"
payload = { "coverages": [
{
"carrier_config": {},
"carrier_id": "9a0a7437-4097-4251-9e71-85384c0eb1c9",
"created": 1557512389,
"lines_of_coverage": { "medical": { "adding_coverage": [
{
"id": "fd62665c-0846-4e9d-bd29-80779b5f685c",
"member_type": "dependent",
"plan_id": "b988cd26-121a-4dd6-b0be-09399f6ecc0a"
}
] } },
"modified": 1564440756,
"signature_date": "2022-01-15"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
coverages: [
{
carrier_config: {},
carrier_id: '9a0a7437-4097-4251-9e71-85384c0eb1c9',
created: 1557512389,
lines_of_coverage: {
medical: {
adding_coverage: [
{
id: 'fd62665c-0846-4e9d-bd29-80779b5f685c',
member_type: 'dependent',
plan_id: 'b988cd26-121a-4dd6-b0be-09399f6ecc0a'
}
]
}
},
modified: 1564440756,
signature_date: '2022-01-15'
}
]
})
};
fetch('https://fulfillment.noyo.com/api/v1/employees/{employee_id}/member_requests/open_enrollment', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://fulfillment.noyo.com/api/v1/employees/{employee_id}/member_requests/open_enrollment",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'coverages' => [
[
'carrier_config' => [
],
'carrier_id' => '9a0a7437-4097-4251-9e71-85384c0eb1c9',
'created' => 1557512389,
'lines_of_coverage' => [
'medical' => [
'adding_coverage' => [
[
'id' => 'fd62665c-0846-4e9d-bd29-80779b5f685c',
'member_type' => 'dependent',
'plan_id' => 'b988cd26-121a-4dd6-b0be-09399f6ecc0a'
]
]
]
],
'modified' => 1564440756,
'signature_date' => '2022-01-15'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://fulfillment.noyo.com/api/v1/employees/{employee_id}/member_requests/open_enrollment"
payload := strings.NewReader("{\n \"coverages\": [\n {\n \"carrier_config\": {},\n \"carrier_id\": \"9a0a7437-4097-4251-9e71-85384c0eb1c9\",\n \"created\": 1557512389,\n \"lines_of_coverage\": {\n \"medical\": {\n \"adding_coverage\": [\n {\n \"id\": \"fd62665c-0846-4e9d-bd29-80779b5f685c\",\n \"member_type\": \"dependent\",\n \"plan_id\": \"b988cd26-121a-4dd6-b0be-09399f6ecc0a\"\n }\n ]\n }\n },\n \"modified\": 1564440756,\n \"signature_date\": \"2022-01-15\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://fulfillment.noyo.com/api/v1/employees/{employee_id}/member_requests/open_enrollment")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"coverages\": [\n {\n \"carrier_config\": {},\n \"carrier_id\": \"9a0a7437-4097-4251-9e71-85384c0eb1c9\",\n \"created\": 1557512389,\n \"lines_of_coverage\": {\n \"medical\": {\n \"adding_coverage\": [\n {\n \"id\": \"fd62665c-0846-4e9d-bd29-80779b5f685c\",\n \"member_type\": \"dependent\",\n \"plan_id\": \"b988cd26-121a-4dd6-b0be-09399f6ecc0a\"\n }\n ]\n }\n },\n \"modified\": 1564440756,\n \"signature_date\": \"2022-01-15\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://fulfillment.noyo.com/api/v1/employees/{employee_id}/member_requests/open_enrollment")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"coverages\": [\n {\n \"carrier_config\": {},\n \"carrier_id\": \"9a0a7437-4097-4251-9e71-85384c0eb1c9\",\n \"created\": 1557512389,\n \"lines_of_coverage\": {\n \"medical\": {\n \"adding_coverage\": [\n {\n \"id\": \"fd62665c-0846-4e9d-bd29-80779b5f685c\",\n \"member_type\": \"dependent\",\n \"plan_id\": \"b988cd26-121a-4dd6-b0be-09399f6ecc0a\"\n }\n ]\n }\n },\n \"modified\": 1564440756,\n \"signature_date\": \"2022-01-15\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"body": {
"coverages": [
{
"carrier_config": {},
"carrier_id": "9a0a7437-4097-4251-9e71-85384c0eb1c9",
"lines_of_coverage": {
"medical": {
"adding_coverage": [
{
"id": "fd62665c-0846-4e9d-bd29-80779b5f685c",
"member_type": "dependent",
"plan_id": "b988cd26-121a-4dd6-b0be-09399f6ecc0a"
}
]
}
},
"signature_date": "2022-01-15"
}
]
},
"employee_id": "30b74a44-d5b1-4123-a7a4-6d3aec251ba4",
"id": "f4517b87-275a-42e1-85e5-47ea6ab5312b",
"request_type": "open_enrollment",
"status": "processing",
"transactions": [
"579952dd-9a66-4587-a4f7-72a63bf9ec86"
]
}The Member Request workflow is now deprecated in favor of using Member
Snapshot
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The unique identifier of the employee related to the member request
Example:
"30b74a44-d5b1-4123-a7a4-6d3aec251ba4"
Body
application/json
Response
201 - application/json
Successful Response - Returns the new Member Request
Data required to execute a member request, varies depending on the request type
The date the record was created
Unique identifier of the employee in Noyo
Unique identifier of the record in Noyo
The date the record was last updated
Transaction type for the member request
Available options:
demographic, new_hire, termination, open_enrollment, qualifying_life_event, enrollment_snapshot, cobra_enrollment, cobra_termination, cobra_open_enrollment, cobra_qualifying_life_event Result from executing the member request, varies depending on the request type
Status of the member request
Available options:
processing, completed, failed, canceled Current version of the record
Timestamp indicating when a member request was marked as completed
List of unique identifiers of all associated member transactions in Noyo
Was this page helpful?
⌘I