Send Test Notification

POST /test-notification
Copied
Arrow
                https://api.ocamba.com/v1/hood/test-notification

Returns a list of Providers

Request Body Schema
Arrow
Name
Description
integrationintegrationsrequired
The integration body you're trying to send a test notification.
Integration
Name
Description
company_idstring
A unique company identifier generated by the Ocamba platform.


Example: 1000000
create_timestring
Timezone: GMT.


Example: 2021-10-29 12:47:00
effective_statusstring
The effective status of the integration. It may differ from the status field, if not tested or if the test is not successful.


Example: active
idstring
A unique identifier of the Integration, generated by the Ocamba platform.


Example: 1000
is_defaultboolean
Determines whether an integration is default or not. Default integration will be useed for sending messages to a user, unless otherwise specified.


Example: true
namestring
The Name of the integration. A string of minimal 1 and maximal 100 characters.


Example: My First Integration
providerproviders

Provider
Name
Description
company_idstring
A unique identifier of the Company the user is a member of, generated by the Ocamba platform.


Example: 1000000
create_timestring
Timezone: GMT.


Example: 2021-10-29 12:47:00
idstring
A unique identifier of the Provider, generated by the Ocamba platform.


Example: 1000000
logostring
The provider logo. String of maximum 100 characters.


Example: https://example.com/logo.jpg
namestring
The name of the Provider.


Example: twilio
settings[ provider-settings ]
The settings of the provider required for the integration to be successful.
Settings
Name
Description
deprecatedboolean
Determines whether this parameter is deprecated.


Example: true
namestring
The name of the parameter, from 1 to 100 characters range.


Example: p_key
requiredboolean
Determines whether this parameter is mandatory.


Example: true
titlestring
The title of the parameter, from 1 to 100 characters range.


Example: Private key
typestring
The type of the parameter.


Example: integer

Possible values: string | integer | boolean
titlestring
The title of the Provider.


Example: Twilio SMS
typestring
The provider type.


Example: sms

Possible values: sms | email | telegram

Default: sms
update_timestring
Timezone: GMT.


Example: 2021-10-30 14:27:26
provider_idstring
The id of the provider. To check for valid provider id's you can list them on the /providers endpoint.


Example: 1000
provider_namestring
The name of the provider. It is inherited from the provider_id.


Example: twilio_sms
settingstwilio-integration

custom-email-integration

mandrill-integration

sendgrid-integration

mitto-integration

mailgun-integration

telegram-integration
The settings of the integration. These are specific by provider. The input params differ by provider.
twilio_sms
Name
Description
account_sidstring
A Twilio Account SID is a 34-character alphanumeric identifier that can be found on the dashboard when logging into the Twilio Console.


Example: ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
auth_tokenstring
The Auth Token is a secret key that used by Twilio to authenticate API requests that can be found on the dashboard when logging into the Twilio Console.


Example: Jd4pbV9BtHC6Q9EdymQhZ4aJgZ8AgFi9
default_phone_numberstring
Twilio phone number


Example: +14155552671
custom_email_provider
Name
Description
default_sender_emailstring
The 'from' email address.


Example: [email protected]
default_sender_namestring
The name that will be displayed as the sender name.


Example: John Doe
passwordstring
The password for your email account registered on the email domain you've specified.


Example: yourExamplePassword123
portstring
The SMTP port your email domain uses.


Example: 587
sending_domainstring
Email domain.


Example: ex.example.com
usernamestring
The username registered on your email domain through which you're actually sending the email.


Example: [email protected]
mandrill_email
Name
Description
api_keystring
A Mandrill Account API key. Provided to you by the Mandrill platform


Example: ad-79XXXXXXXXXXXXXXXXXXXXXX
default_reply_to_emailstring
The reply-to email address that will be displayed in the email.


Example: [email protected]
default_sender_emailstring
The email address which will be the actual sender of the notification


Example: [email protected]
default_sender_namestring
The name that will be displayed as the sender name


Example: John Doe
smtp_usernamestring
The SMTP host name for Mandrill.


Example: exampleName
sendgrid_email
Name
Description
api_keystring
A Mandrill Account API key. Provided to you by the SendGrid platform.


Example: SG.EGXXXXXXXXXXXXXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXXX
default_reply_to_emailstring
The reply-to email address that will be displayed in the email. If the reply-to email is provided, it has to match the reply-to email from your SendGrid account.


Example: [email protected]
default_sender_emailstring
The email address which will be the actual sender of the notification. This has to match the sender email from your SendGrid account.


Example: [email protected]
default_sender_namestring
The name that will be displayed as the sender name.


Example: John Doe
mitto_sms
Name
Description
api_keystring
The api key generated by the Mitto platform. Use this key to successfully send messages via this provider.


Example: AScs8XXXXXXXXXXXXXXXXXXXXXXXXXXXXX
sender_namestring
The name of the sender that will be displayed to the user receiving the message.


Example: Ocamba Integration
mailgun_email
Name
Description
api_keystring
A Mailgun Account API key. Provided to you by the Mailgun platform.


Example: 563cXXXXXXXXXXXXXXXXXXX-XXXXXXXXX-XXXXXXXXX
domainstring
The domain of your Mailgun account. Provided to you by the Mailgun platform.


Example: sandboxXXXXXXXXXXXXXXXXXXXXXXXXX.mailgun.org
sender_emailstring
The email address which will be the actual sender of the notification.


Example: [email protected]
sender_namestring
The sender name that will appear when a user recieves the email.


Example: John Doe
telegram
Name
Description
auth_tokenstring
A telegram bot authentication token. Provided by the telegram API.


Example: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
chat_idstring
A telegram unique chat identifier. Provided by the telegram API.


Example: 8171131924
statusstring
The status of the integration. Active integrations can be used to send SMS messages.


Example: active

Possible values: active | inactive
typestring
The type of the integration. It depends on the selected provider type.

Possible values: sms | email | telegram
update_timestring
Timezone: GMT.


Example: 2021-10-30 14:27:26
recipientstringrequired
Based on the integration type, this should be a valid e164 mobile phone or an email address.


Example: +38160XXXXXXX | [email protected]
Response status codes
Arrow
204 - No Content
Arrow

note
1 The default phone number located in the settings differs from the recipient. Both of them should be in the e163 format. The recipient is the actual mobile phone number of the SMS recipient. The default phone number is the phone number of the Twilio account from which the SMS will be sent.
tip
1 List the providers if you don't know the provider id.
warning
1 For different providers you will have different type of recipient. It is based on the provider and integration type.

Request examples
Copied
Arrow
Twilio Arrow
  • Twilio
  • Mitto
  • Custom Email Provider
  • Mailchimp
  • SendGrid
  • Mailgun
{
  "integration:"{
    "name": "Example Twilio",
    "provider_id": "1000",
    "settings": {
      "account_sid": "AC7XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "auth_token": "464XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "default_phone_number": "+121XXXXXXXXX"
    },
    "status": "active"
  },
  "recipient": "+38163XXXXXXX"
  }

{
  "integration": {
    "name": "Example Mitto",
    "provider_id": "1004",
    "settings": {
      "api_key": "AScs8XXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "sender_name": "Example Name",
    },
    "status": "active"
  },
  "recipient": "+38163XXXXXXX"
}

{
  "integration":{
    "name": "Example Custom",
    "provider_id": "1001",
    "settings": {
      "default_sender_email": "[email protected]",
      "default_sender_name": "John Doe",
      "sending_domain": "ex.example.com",
      "port": "587",
      "username": "[email protected]",
      "password": "yourPassword123"
    },
    "status": "active"
  },
  "recipient": "[email protected]"
}

{
  "integration":{
    "name": "Example Mailchimp",
    "provider_id": "1002",
    "settings": {
      "api_key": "md-c8XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "default_sender_name": "Example Name",
      "default_sender_email": "[email protected]",
      "default_reply_to_email":"[email protected]"
    },
    "status": "active"
  },
  "recipient": "[email protected]"
}

{
  "integration": {
    "name": "Example SendGrid",
    "provider_id": "1003",
    "settings": {
      "api_key": "SG.EKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "default_sender_name": "Example Name",
      "default_sender_email": "[email protected]",
      "default_reply_to_email":"[email protected]"
    },
    "status": "active"
  },
  "recipient": "[email protected]"
}

{
  "integration":{
    "name": "Example Mailgun",
    "provider_id": "1005",
    "settings": {
      "api_key": "568cXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-XXXXXXXX-XXXXXXXX",
      "domain":"sandboxXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.mailgun.org"
      "sender_email": "[email protected]",
      "sender_name": "John Doe",
    },
    "status": "active"
  },
  "recipient": "[email protected]"
}