Push Providers

The Push Providers API provides operations to manage Push Providers for your organization.

List all Push Providers
Identity Engine
OAuth 2.0: okta.pushProviders.read

Lists all push providers

Request
query Parameters
type
string (ProviderType)

Filters push providers by providerType

Enum: "APNS" "FCM"
Responses
200

OK

403

Forbidden

429

Too Many Requests

get/api/v1/push-providers
Request samples 
Response samples 
application/json
[
  • {
    • "id": "string",
    • "lastUpdatedDate": "string",
    • "name": "string",
    • "providerType": "APNS",
    • "_links": {
      }
    }
]
Create a Push Provider
Identity Engine
OAuth 2.0: okta.pushProviders.manage
Creates a new push provider


Request 
Request Body schema: application/json
required
name
string
Display name of the push provider


 
providerType
string (ProviderType) 
 
object (APNSConfiguration) 
 
fileName
string
(Optional) File name for Admin Console display


 
keyId
string
10-character Key ID obtained from the Apple developer account


 
teamId
string
10-character Team ID used to develop the iOS app


 
tokenSigningKey
string
APNs private authentication token signing key


 
Responses 
200
OK


400
Bad Request


403
Forbidden


429
Too Many Requests


post/api/v1/push-providers
Request samples 
application/json
{
  • "name": "APNs Example",
  • "providerType": "APNS",
  • "configuration": {
    • "keyId": "KEY_ID",
    • "teamId": "TEAM_ID",
    • "tokenSigningKey": "-----BEGIN PRIVATE KEY-----\\nPRIVATE_KEY\\n-----END PRIVATE KEY-----\\n",
    • "fileName": "fileName.p8"
    }
}
Response samples 
application/json
{}
Retrieve a Push Provider
Identity Engine
OAuth 2.0: okta.pushProviders.read
Retrieves a push provider by pushProviderId


Request 
path Parameters
pushProviderId
required
string
Id of the push provider


 
Responses 
200
OK


403
Forbidden


404
Not Found


429
Too Many Requests


get/api/v1/push-providers/{pushProviderId}
Request samples 
Response samples 
application/json
{}
Replace a Push Provider
Identity Engine
OAuth 2.0: okta.pushProviders.manage
Replaces a push provider by pushProviderId


Request 
path Parameters
pushProviderId
required
string
Id of the push provider


 
Request Body schema: application/json
required
name
string
Display name of the push provider


 
providerType
string (ProviderType) 
 
object (APNSConfiguration) 
 
fileName
string
(Optional) File name for Admin Console display


 
keyId
string
10-character Key ID obtained from the Apple developer account


 
teamId
string
10-character Team ID used to develop the iOS app


 
tokenSigningKey
string
APNs private authentication token signing key


 
Responses 
200
OK


400
Bad Request


403
Forbidden


404
Not Found


429
Too Many Requests


put/api/v1/push-providers/{pushProviderId}
Request samples 
application/json
{
  • "name": "APNs Example",
  • "providerType": "APNS",
  • "configuration": {
    • "keyId": "KEY_ID",
    • "teamId": "TEAM_ID",
    • "tokenSigningKey": "-----BEGIN PRIVATE KEY-----\\nPRIVATE_KEY\\n-----END PRIVATE KEY-----\\n",
    • "fileName": "fileName.p8"
    }
}
Response samples 
application/json
{}
Delete a Push Provider
Identity Engine
OAuth 2.0: okta.pushProviders.manage
Deletes a push provider by pushProviderId. If the push provider is currently being used in the org by a custom authenticator, the delete will not be allowed.


Request 
path Parameters
pushProviderId
required
string
Id of the push provider


 
Responses 
204
No Content


403
Forbidden


404
Not Found


409
Conflict


429
Too Many Requests


delete/api/v1/push-providers/{pushProviderId}
Request samples 
Response samples 
application/json
{
  • "errorCode": "E0000006",
  • "errorSummary": "You do not have permission to perform the requested action",
  • "errorLink": "E0000006",
  • "errorId": "sampleNUSD_8fdkFd8fs8SDBK",
  • "errorCauses": [ ]
}