Go

package example

import (
    client "github.com/auth0/go-auth0/management/client"
    option "github.com/auth0/go-auth0/management/option"
    context "context"
    emails "github.com/auth0/go-auth0/management/emails"
    management "github.com/auth0/go-auth0/management"
)

func do() () {
    client := client.NewClient(
        option.WithToken(
            "<token>",
        ),
    )
    client.Emails.Provider.Create(
        context.TODO(),
        &emails.CreateEmailProviderRequestContent{
            Name: management.EmailProviderNameEnumMailgun,
            Credentials: &management.EmailProviderCredentialsSchema{
                EmailProviderCredentialsSchemaZero: &management.EmailProviderCredentialsSchemaZero{
                    ApiKey: "api_key",
                },
            },
        },
    )
}

{
  "name": "sendgrid",
  "enabled": true,
  "default_from_address": "<string>",
  "credentials": {
    "api_user": "<string>",
    "region": "<string>",
    "smtp_host": "<string>",
    "smtp_port": 123,
    "smtp_user": "<string>"
  },
  "settings": {}
}

Configure email provider

Create an email provider. The credentials object requires different properties depending on the email provider (which is specified using the name property):

mandrill requires api_key
sendgrid requires api_key
sparkpost requires api_key. Optionally, set region to eu to use the SparkPost service hosted in Western Europe; set to null to use the SparkPost service hosted in North America. eu or null are the only valid values for region.
mailgun requires api_key and domain. Optionally, set region to eu to use the Mailgun service hosted in Europe; set to null otherwise. eu or null are the only valid values for region.
ses requires accessKeyId, secretAccessKey, and region
smtp requires smtp_host, smtp_port, smtp_user, and smtp_pass

Depending on the type of provider it is possible to specify settings object with different configuration options, which will be used when sending an email:

smtp provider, settings may contain headers object.
- When using AWS SES SMTP host, you may provide a name of configuration set in X-SES-Configuration-Set header. Value must be a string.
- When using Sparkpost host, you may provide value for X-MSYS_API header. Value must be an object.
for ses provider, settings may contain message object, where you can provide a name of configuration set in configuration_set_name property. Value must be a string.

POST

https://{tenantDomain}/api/v2

/

emails

/

provider

Go

package example

import (
    client "github.com/auth0/go-auth0/management/client"
    option "github.com/auth0/go-auth0/management/option"
    context "context"
    emails "github.com/auth0/go-auth0/management/emails"
    management "github.com/auth0/go-auth0/management"
)

func do() () {
    client := client.NewClient(
        option.WithToken(
            "<token>",
        ),
    )
    client.Emails.Provider.Create(
        context.TODO(),
        &emails.CreateEmailProviderRequestContent{
            Name: management.EmailProviderNameEnumMailgun,
            Credentials: &management.EmailProviderCredentialsSchema{
                EmailProviderCredentialsSchemaZero: &management.EmailProviderCredentialsSchemaZero{
                    ApiKey: "api_key",
                },
            },
        },
    )
}

{
  "name": "sendgrid",
  "enabled": true,
  "default_from_address": "<string>",
  "credentials": {
    "api_user": "<string>",
    "region": "<string>",
    "smtp_host": "<string>",
    "smtp_port": 123,
    "smtp_user": "<string>"
  },
  "settings": {}
}

Autorisations

Authorization

string

header

requis

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Corps

name

enum<string>

requis

Name of the email provider. Can be mailgun, mandrill, sendgrid, ses, sparkpost, smtp, azure_cs, ms365, or custom.

Options disponibles:

mailgun,

mandrill,

sendgrid,

ses,

sparkpost,

smtp,

azure_cs,

ms365,

custom

credentials

object

requis

Credentials required to use the provider.

Show child attributes

enabled

boolean

défaut:true

Whether the provider is enabled (true) or disabled (false).

default_from_address

string

Email address to use as "from" when no other address specified.

settings

object

Specific provider setting

Réponse

Email provider successfully created.

name

string

défaut:sendgrid

Name of the email provider. Can be mailgun, mandrill, sendgrid, ses, sparkpost, smtp, azure_cs, ms365, or custom.

enabled

boolean

défaut:true

Whether the provider is enabled (true) or disabled (false).

default_from_address

string

Email address to use as "from" when no other address specified.

credentials

object

Credentials required to use the provider.

Show child attributes

settings

object

Specific provider setting

Update email provider

Get event streams

⌘I